add html boilerplate
[tools.git] / doc / misc.md
blob:a/doc/misc.md -> blob:b/doc/misc.md
--- a/doc/misc.md
+++ b/doc/misc.md
@@ -1,1 +1,26 @@
+[HTML5 Boilerplate homepage](http://html5boilerplate.com) | [Documentation table of contents](README.md)
 
+# Miscellaneous
+
+## .gitignore
+
+HTML5 Boilerplate includes a basic project-level `.gitignore`. This should
+primarily be used to avoid certain project-level files and directories from
+being kept under source control. Different development-environments will
+benefit from different collections of ignores.
+
+OS-specific and editor-specific files should be ignored using a "global
+ignore" that applies to all repositories on your system.
+
+For example, add the following to your `~/.gitconfig`, where the `.gitignore`
+in your HOME directory contains the files and directories you'd like to
+globally ignore:
+
+```gitignore
+[core]
+    excludesfile = ~/.gitignore
+```
+
+* More on global ignores: http://help.github.com/ignore-files/
+* Comprehensive set of ignores on GitHub: https://github.com/github/gitignore
+