In my opinion, as user, is much simpler to have the documentation in sync with the code, thus in the same repository. asciidoc and rfcxml processors are easy to get if you want. If, to please the picky windows user, we want to provide on *release* a nanomsg-docs-${version}.7z it is easy to do with a dist-hook w/out having the pain to keep synced branches. As developer, as long editing the docs doesn't require special tools or large deployments such pandoc or any flavour of TeX, I should stay happy. As packager I prefer having a --enable-doc switch to enable/disable docs generation. lu