Boilerplate README to rustle @maddox's jimmies

README.md

@@ -1,4 +1,19 @@
-Archimedes
-==========
+# Archimedes
 
-Geometry functions for Cocoa and Cocoa Touch
+Archimedes contains useful geometry functions for your Cocoa or Cocoa Touch application.
+
+This framework is very much a work in progress at the moment, and should be considered **alpha quality**. Breaking changes may happen often during this time.
+
+## Getting Started
+
+To start building the framework, clone this repository and then run `git submodule update --init --recursive`. This will automatically pull down any dependencies.
+
+## Contributing
+
+Fork this repository, make it awesomer (preferably in a branch named for the topic), send a pull request!
+
+All contributions should match our [coding conventions](https://github.com/github/objective-c-conventions).
+
+## License
+
+Archimedes is released under the MIT license. See [LICENSE.md](https://github.com/github/Archimedes/blob/master/LICENSE.md).