[gnome-shell/wip/fmuellner/doc-updates] Update README.md

[Florian Müllner <fmuellner src gnome org>]

commit d6cb8541145b88691c5d2601eab14ed5661f9137
Author: Florian Müllner <florian muellner gmail com>
Date:   Wed May 23 16:59:04 2018 +0000

    Update README.md

 data/theme/README.md | 22 ++++++++++------------
 1 file changed, 10 insertions(+), 12 deletions(-)
---
diff --git a/data/theme/README.md b/data/theme/README.md
index 990fd4441..7ca9cb2e1 100644
--- a/data/theme/README.md
+++ b/data/theme/README.md
@@ -11,24 +11,22 @@ Adwaita is a complex theme, so to keep it maintainable it's written and
 processed in SASS, the generated CSS is then transformed into a gresource
 file during gtk build and used at runtime in a non-legible or editable form.
 
-It is very likely your change will happen in the `_common.scss` file.
+It is very likely your change will happen in the [_common.scss][common] file.
 That's where all the widget selectors are defined. Here's a rundown of
 the "supporting" stylesheets, that are unlikely to be the right place
 for a drive by stylesheet fix:
 
-`_colors.scss`      - global color definitions. We keep the number of defined colors to a necessary minimum, 
-                      most colors are derived from a handful of basics. It is an exact copy of the gtk+ 
-                      counterpart. Light theme is used for the classic theme and dark is for GNOME3 shell 
-                      default.
-
-`_drawing.scss`     - drawing helper mixings/functions to allow easier definition of widget drawing under
-                      specific context. This is why Adwaita isn't 15000 LOC.
-
-`_common.scss`      - actual definitions of style for each widget. This is where you are likely to add/remove
-                      your changes.
+| File                     | Description       |
+| ------------------------ | ----------------- |
+| [_colors.scss][colors]   | global color definitions. We keep the number of defined colors to a necessary 
minimum,  most colors are derived from a handful of basics. It is an exact copy of the gtk+ counterpart. 
Light theme is used for the classic theme and dark is for GNOME3 shell default. |
+| [_drawing.scss][drawing] | drawing helper mixings/functions to allow easier definition of widget drawing 
under specific context. This is why Adwaita isn't 15000 LOC. |
+| [_common.scss][common]   | actual definitions of style for each widget. This is where you are likely to 
add/remove your changes. |
                       
 You can read about SASS on its [web page][sass-web]. Once you make your
-changes to the `_common.scss` file, you can run ninja to generate the
+changes to the [_common.scss][common] file, you can run ninja to generate the
 final CSS files.
 
+[common]: data/theme/gnome-shell-sass/_common.scss
+[colors]: data/theme/gnome-shell-sass/_colors.scss
+[drawing]: data/theme/gnome-shell-sass/_drawing.scss
 [sass-web]: http://sass-lang.com/documentation/