We ended up with Slate because: 1. readme.io is just painful to use for larger documentations; very GUI-oriented 2. apiary is basically just annoying in every

We ended up with Slate because: 1. readme.io is just painful to use for larger documentations; very GUI-oriented 2. apiary is basically just annoying in every way (I really like the company so I tried 3 separate times to get myself to like their product) 3. I dismissed a couple of self-hosted options that use JS to render the information, since I find that idiotic Slate struck a good balance between (1) syntax (2) ease of use and (3) good looks, although I wouldn't call it prefect in any of those departments. Disclaimer: the end result looks surprisingly better than what you'd expect.