Merge "Add ability to generate KSS files for mediawiki.ui"

[lhc/web/wiklou.git] / resources / mediawiki.ui / vector.less

diff --git a/resources/mediawiki.ui/vector.less b/resources/mediawiki.ui/vector.less
index f736b5c..d084731 100644 (file)
--- a/resources/mediawiki.ui/vector.less
+++ b/resources/mediawiki.ui/vector.less
@@ -4,6 +4,25 @@
 
 // FIXME: remove import for button styles as soon as extensions using mediawiki.ui are
 // updated to use mediawiki.ui.button as well.
+
+// Typography
+//
+// We prefer the usage of Georgia Bold for all headings. Georgia Regular is used to place emphasis on pull-out or short quotations. This latter usage should be used sparingly. 
+//
+// We prefer the use of Helvetica Neue Regular for body copy. Helvetiva Neue Bold for sub-headers. Pull-out quotes within the body copy should use Helvetica Neue Bold. Helvetica Neue is an not open-source font. Hence, below is a list of preferred alternate choices.
+//
+// Second choice: Helvetica
+//
+// Third choice: Arial
+//
+// Our content is predominantly text, hence visual hierarchy must be clear. Use these recommended type sizes to inform and establish information hierarchy and organization. 
+//
+// Unless if you plan to put extra attention and manually adjust spacing, avoid justifying texts and paragraphs as they are harder to read and create unnecessary visual distractions. Along with centered text, they convey a formal and less friendly environment. 
+//
+// It will be important to talk about other languages, scripts and writing direction - with the same level as importance, not as an afterthought.
+//
+// Styleguide 1.
+
 @import "components/utilities";
 @import "components/vector/buttons";
 @import "components/vector/forms";