Issue 5413 - Create basic style guide for website-defaults

includes/styleguide/typography/index.md

Index: includes/styleguide/typography/index.md
===================================================================
new file mode 100644
--- /dev/null
+++ b/includes/styleguide/typography/index.md
@@ -0,0 +1,11 @@
+
+## Typography { #typography } 

[juliandoucette, 2017/08/10 16:49:29]

Regarding the use of Markdown vs HTML:

- We (content and website developers) have agreed to prefer HTML
  - Therefore a styleguide for our sake should be based in HTML
- We (Websites Infrastructure) support Markdown for the sake of
non-(content|website)-developers
  - Mixing markdown with includes may be confusing for non-developers

Therefore I would propose that we create two styleguides:

1. For website developers (with includes and additional components)
2. For non-content-developers (minimal, without includes, without components
e.g. grid)

- Sorry for the confusion :(
- If you agree then we could review one or two of these style guides in this
review

[ire, 2017/08/11 11:09:47]

Okay this makes sense. If we are intending that non-content-developers will look
at the markup/markdown in order to see how things work, you're right that it
should be without includes and plainly in markdown.
No worries :)
I agree :)

+
+### Headings { #headings }

[juliandoucette, 2017/08/10 16:49:29]

NIT: Please separate markdown headings by one blank line

[ire, 2017/08/11 11:09:47]

Done.

+<? include styleguide/typography/headings ?>
+
+### Body content { #body-content }
+<? include styleguide/typography/body ?>
+
+### Blockquotes { #blockquotes }
+<? include styleguide/typography/blockquotes ?>