Add readmes

Author: johno

build/readme.md

@@ -0,0 +1,7 @@
+# `build`
+
+A lot of the files to build the Tachyons documentation are generated with build scripts.
+All of those scripts and their source contents are found here.
+
+There are two primary build pipelines, one for metadata that's shared throughout the site (like the latest Tachyons version or css stats).
+The second for generating component documentation found at [`/components`](https://tachyons.io/components).

components/t/readme.md

@@ -0,0 +1,4 @@
+# `components/t`
+
+This is where the components used by the docs site live.
+They have a special directory so they don't get mixed up with the component documentation.

readme.md

@@ -0,0 +1,50 @@
+# [TACHYONS](https://tachyons.io)
+
+Where the documentation lives for <https://tachyons.io>.
+
+### Installation
+
+##### Running the web app
+
+```sh
+git clone https://github.com/tachyons-css/tachyons-css.github.io
+npm i && npm run dev
+```
+
+##### Building component documentation
+
+Run the build for all components (this will take a while)
+
+```sh
+npm run build:components
+```
+
+Run the build for a particular component category
+
+```sh
+npm run build:components lists
+```
+
+## Related
+
+- [`tachyons`](https://github.com/tachyons-css/tachyons)
+- [`tachyons-x-ray`](https://github.com/tachyons-css/tachyons-x-ray)
+- [`cssstats`](https://github.com/cssstats/cssstats)
+- [`immutable-css`](https://github.com/johnotander/immutable-css)
+- [`next`](https://github.com/zeit/next.js)
+
+## License
+
+MIT
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+***
+
+> Made by [@mrmrs_](https://twitter.com/mrmrs_), [@4lpine](https://twitter.com/4lpine) & contributors