Permalink
Browse files

first

  • Loading branch information...
0 parents commit 7c335b26a0ad13ad1efd6265cb5bb0148c44d80d Mark Phillips committed Jan 4, 2012
Showing with 22 additions and 0 deletions.
  1. +22 −0 README.md
@@ -0,0 +1,22 @@
+# Beautiful Docs
+
+I love documentation. If you work with/are writing code intended for usage and consumption by more than one person, you should love it, too. Documentation and other resources will make or break the success of your project. And the more open and collaborative you want development to be, the more crucial docs become.
+
+With that in mind, here's a list of docs and other developer resources that myself and others find particularly useful, well-written, and otherwise "beautiful". May they serve to inspire you when writing and designing yours.
+
+This should be updated fairly regularly. As usual, **pull requests are encouraged**.
+
+[Mark](https://twitter.com/pharkmillups)
+
+### And Now For The Docs (in no particular)
+
+* [Redis Commands](http://redis.io/commands) - Most of the Redis docs are exceptional, but this section really epitomizes the combination of good design and usability. And all the individual command pages give you the ability to test things out without leaving the page. Pretty close to perfect.
+* [BrightBox Devloper Docs](docs.brightbox.com) - Clean design, easy to navigate, very in-depth.
+* [Riaknostic](riaknostic.basho.com) - Made possible by [Bootstrap](https://github.com/twitter/bootstrap), this is a great example of a project homepage that doubles as a documentation teaser.
+* [GitHub Developer Docs](http://developer.github.com/v3/) - I don't always get excited about accordion-based navigation, but when I do...
+* [Dropwizard](http://dropwizard.codahale.com/) Beautiful and concise; another Bootstrap joint.
+* [Riak Pipe README](github.com/basho/riak_pipe) - The simplicity of READMEs means that you can't obscure shitty content with flashy design. This one is written by my Basho colleague [Bryan Fink](https://twitter.com/#!/hobbyist) and should be committed to memory as an excellent example.
+* [Learn You Some Erlang](http://learnyousomeerlang.com/) (via [@lenary](https://twitter.com/lenary))
+* [Django Documentation](https://docs.djangoproject.com/en/1.3/) (via [@bretthoerner](https://twitter.com/bretthoerner))
+* [Erldocs.com](http://erldocs.com/) (via [@bradfordw](https://twitter.com/#!/bradfordw))
+

0 comments on commit 7c335b2

Please sign in to comment.