On Thu, 25 Jul 2019 at 17:34, John Snow <js...@redhat.com> wrote: > Yup; I think a single point of entry would be nice -- I think we need to > start hosting our sphinx documentation because it's confusing that we > have both the traditional manual (hosted by Stefan Weil) and this newer > one that isn't available anywhere. > > The interop manual in particular is crucial to get hosted.
Yes, this would be a good thing. > We could perhaps formalize this as follows: > > - index.rst, which is an "absolutely everything included" single point > of entry manual for developers and contributors, > > - user.rst, which could be a single point of entry for end users, to be > bundled in distro packaging. This means you'll end up building 90% of our documentation twice, which is something I was trying to avoid with the current setup. It occurs to me that we don't necessarily need the 'top level' page to be generated by Sphinx -- we could just ship an index.html which has helpful links to the individual manuals. (https://wiki.qemu.org/Features/Documentation is the current plan and lists the various manuals we'll end up with. 'user' in that plan means the documentation for the user-mode emulation.) thanks -- PMM