diff --git a/client/README.md b/client/README.md
index 84563e8666c..a73a76a222c 100644
--- a/client/README.md
+++ b/client/README.md
@@ -65,8 +65,8 @@ Changing Styles/CSS
===================
The CSS and styling used by Galaxy is also controlled from this directory.
-Galaxy uses LESS, a superset of CSS that compiles to CSS, for its styling. LESS
-files are kept in client/galaxy/style/less. Compiled CSS is in
+Galaxy uses Sass for its styling, a superset of CSS that compiles to CSS. Sass
+files are kept in client/galaxy/style/scss. Compiled CSS is in
static/style/blue.
As mentioned above, 'make client' will also rebuild styles. If you *only* want
diff --git a/client/galaxy/docs/README.md b/client/galaxy/docs/README.md
new file mode 100644
index 00000000000..b57412ac27e
--- /dev/null
+++ b/client/galaxy/docs/README.md
@@ -0,0 +1,5 @@
+The \*.md files in this directory are rendered as a style guide generated when
+running ```yarn run styleguide```.
+
+For more details see [Vue
+Styleguidist](https://github.com/vue-styleguidist/vue-styleguidist).
diff --git a/client/galaxy/docs/bootstrap.md b/client/galaxy/docs/bootstrap.md
index ec879739331..d62f23def6f 100644
--- a/client/galaxy/docs/bootstrap.md
+++ b/client/galaxy/docs/bootstrap.md
@@ -2,7 +2,7 @@
Regular buttons
-```
+```vue
diff --git a/client/galaxy/docs/galaxy-buttons.md b/client/galaxy/docs/galaxy-buttons.md
index a2e41c20128..b959cb7ce60 100644
--- a/client/galaxy/docs/galaxy-buttons.md
+++ b/client/galaxy/docs/galaxy-buttons.md
@@ -1,24 +1,24 @@
## Buttons
-```
+```vue
```
-```
+```vue
An anchor with .action-button
```
All the crazy permutations of menu button...
-```
+```vue
An anchor with .menu-button
```
-```
+```vue
An anchor with .menu-button.popup
```
-```
+```vue
An anchor with .menu-button.popup.split
@@ -28,7 +28,7 @@ All the crazy permutations of menu button...
As generated by mvc.ui.ui-options
-```
+```vue