Hi Dirkjan,
Personally, I like Sphinx quite a bit. How about setting up a Sphinx project that has both the reference docs and more guide- or tutorial-like documentation?
Any specific reason for using Sphinx over Asciidoc (given that Asciidoc toolchain is already part of the build process)?
Martin