stub out icons page in docs

diff --git a/docs/_data/nav.yml b/docs/_data/nav.yml
index ffd79a46b4393033bfcc0114669753770d2fadd8..ff46ae70d3ac6e70e3da8446e00e988c0c941f24 100644 (file)
--- a/docs/_data/nav.yml
+++ b/docs/_data/nav.yml
@@ -68,10 +68,10 @@
     - title: Typography
     - title: Vertical align
 
-# - title: Extend
-#   pages:
-#     - title: Approach
-#     - title: Icons
+- title: Extend
+  pages:
+    # - title: Approach
+    - title: Icons
 
 - title: About
   pages:

diff --git a/docs/extend/icons.md b/docs/extend/icons.md
index 9cddafeeaabee89ef1dfe97435dd9a12187cb6ce..c619ed2cea40f79e42a1e3093f31dde4ed2f17c5 100644 (file)
--- a/docs/extend/icons.md
+++ b/docs/extend/icons.md
@@ -1,6 +1,24 @@
 ---
 layout: docs
-title: Icon fonts
+title: Icons
+group: extend
 ---
 
-TODO
+Bootstrap doesn't include an icon library by default, but we have a handful of recommendations for you to choose from. While most icon sets include multiple file formats, we prefer SVG implementations for their improved accessibility and vector support.
+
+## Preferred
+We've tested and used these icon sets ourselves.
+
+- [Iconic](https://useiconic.com/open/)
+- [Octicons](https://octicons.github.com/)
+- [Entypo](http://www.entypo.com/)
+
+## More options
+While we haven't tried these out, they do look promising and provide multiple formats—including SVG.
+
+- [Google Material icons](https://material.io/icons/)
+- [Ionicons](http://ionicons.com/)
+- [Feather](http://colebemis.com/feather/)
+- [Dripicons](http://demo.amitjakhu.com/dripicons/)
+- [Ikons](http://ikons.piotrkwiatkowski.co.uk/)
+- [Glyph](http://glyph.smarticons.co/)