Re: QEMU participation to Google Season of Docs

[Ruben Safir]

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 <address@hidden> 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