The idea: A service for hosting, maintaining, and collaborating on web app documentation. Perhaps a Github meets Posterous for web app documentation.
Nearly every web API has some form of documentation. However, there doesn't appear to be a 'best practice' for generating, hosting, and maintaining such documentation.
I think the hosting of API documentation should be offloaded to a third-party service, like we've seen with blogging (Posterous) and source code (Github).
Questions:
How do you generate/host your API docs?
Who maintains your docs?
What are the pain points?
What features would you want?
Would you pay for it?
Thanks in advance for your feedback. I'd like to build a prototype if people like the idea-- shoot me an email if you want to help (matt.hodan at fb.com).
Merry christmas!