never use google docs
On Mon, Apr 06, 2020 at 11:57:11AM +0100, Peter Maydell wrote: > On Mon, 6 Apr 2020 at 11:35, Paolo Bonzini <[email protected]> wrote: > > On 04/04/20 03:37, John Snow wrote: > > > I have a lot of opinions and thoughts on python and how docs should be > > > laid out, but I'm afraid I'm not so good at understanding all of the > > > options and "use cases" of QEMU to confidently lay out a top-level TOC. > > > Maybe if we collaborated on a TOC we could give a clear project > > > guideline to a GSoC/GSoD contributor. > > > > That's actually how a good technical writer can help us! The main > > problem we have with our docs is the disconnect between docs/system > > (formerly qemu-doc) and the .txt files in docs/. We know the material, > > but it's hard to reorganize docs/system to make room for everything else. > > > > Reorganizing the TOC to fit all the material in both categories would be > > the best outcome of our participation in GSoD. > > Yep, and unlike last year we've actually (almost) completed > the transition to Sphinx so we have a workable structure/tooling > for a tech writer to work with. > > thanks > -- PMM -- So many immigrant groups have swept through our town that Brooklyn, like Atlantis, reaches mythological proportions in the mind of the world - RI Safir 1998 http://www.mrbrklyn.com DRM is THEFT - We are the STAKEHOLDERS - RI Safir 2002 http://www.nylxs.com - Leadership Development in Free Software http://www2.mrbrklyn.com/resources - Unpublished Archive http://www.coinhangout.com - coins! http://www.brooklyn-living.com Being so tracked is for FARM ANIMALS and extermination camps, but incompatible with living as a free human being. -RI Safir 2013
