Initial release

README.md

@@ -1,4 +1,31 @@
-html5-test-page
-===============
+# HTML5 Test Page - 0.1.0
 
-A page filled with common HTML elements to be used for testing purposes. Useful when building CSS systems for projects big and small.
+This is a test page filled with common HTML elements to be used to provide visual feedback whilst building CSS systems and frameworks.
+
+I have not been able to find a sufficient test page out there, so I made one.
+
+The HTML elements are loosely categorized as either text, embedded content, or form elements.
+
+## Versioning
+
+Cardinal will be maintained using the [Semantic Versioning](http://semver.org/) guidelines. From here on out, releases will be numbered using the following format:
+
+`major.minor.patch`
+
+* Breaking backwards compatibility increments `major`, while resetting `minor` and `patch`.
+* New code that does not break backwards compatibility increments `minor`, while resetting `patch`.
+* Bug fixes and other small changes increment `patch`.
+
+## Contributing
+
+Do you have ideas or requests? Please [submit an issue](https://github.com/cbracco/html5-test-page/issues/new) here on GitHub. Or, if you are feeling especially motivated, write some code and submit a pull request!
+
+When submitting a pull request, **please checkout a new feature branch, and submit your pull request from it.** Do not submit pull requests from your `master` branch. Please and thank you.
+
+## License
+
+HTML Test Page is licensed under the MIT Open Source license. For more information, see the [LICENSE.md](https://github.com/cbracco/html5-test-page/blob/master/LICENSE.md) file in this repository.
+
+## Colophon
+
+Made by [@cbracco](http://twitter.com/cbracco).