Hi Sqoopers, I think we all agree that while our docs are useful, they can use some improvement - not just in terms of content, but also in terms of style, usefulness and the process around updating them.
Right now, docs are updated in trunk when we add new features (usually), but these updates are not posted anywhere - so if someone builds from trunk, they have to build the docs and use them locally. When we do a release, we build the docs, copy the result into SVN and push this to our website. Looks a bit clunky to me :) I found a nice project called that can help: https://readthedocs.org/ This is a documentation hosting site that supports git, supports sphinx, and allows tagging and versioning of the documentation. Looks like it can improve our process and make things easier for us and our users. What do you guys think? Any other suggestions on how to make docs better? Gwen
