Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project

2017-02-01 Thread Paolo Bonzini
On 01/02/2017 15:36, G 3 wrote: > On Feb 1, 2017, at 6:17 PM, Paolo Bonzini wrote: >> The requirements for the format are: >> >> * support for HTML and man as output formats, optionally PDF and text >> * support for QEMU's usual submission workflow >> * producing documentation with a consistent l

Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project

2017-02-01 Thread G 3
On Feb 1, 2017, at 6:17 PM, Paolo Bonzini wrote: On 01/02/2017 14:50, G 3 wrote: I was thinking maybe we should add Rich Text Format, or maybe even a word processing format like OpenOffice, or Microsoft Word to the list of possible formats. These formats are super easy to use. No formatti

Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project

2017-02-01 Thread Paolo Bonzini
On 01/02/2017 14:50, G 3 wrote: > I was thinking maybe we should add Rich Text Format, or maybe even a > word processing format like OpenOffice, or Microsoft Word to the list of > possible formats. These formats are super easy to use. No formatting > rules to have to learn. All the user needs to

Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project

2017-02-01 Thread G 3
I was thinking maybe we should add Rich Text Format, or maybe even a word processing format like OpenOffice, or Microsoft Word to the list of possible formats. These formats are super easy to use. No formatting rules to have to learn. All the user needs to do is just type up their contribut

Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project

2017-01-30 Thread Markus Armbruster
Stefan Hajnoczi writes: > On Fri, Jan 27, 2017 at 10:08:49AM +, Peter Maydell wrote: >> On 27 January 2017 at 06:51, Markus Armbruster wrote: >> > "What can we cut" is the wrong question. The right one is "what are our >> > requirements". Here's my try: >> > >> > HTML: required >> > nroff

Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project

2017-01-30 Thread Stefan Hajnoczi
On Fri, Jan 27, 2017 at 10:08:49AM +, Peter Maydell wrote: > On 27 January 2017 at 06:51, Markus Armbruster wrote: > > "What can we cut" is the wrong question. The right one is "what are our > > requirements". Here's my try: > > > > HTML: required > > nroff with an macros: required > > PDF:

Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project

2017-01-27 Thread Peter Maydell
On 27 January 2017 at 06:51, Markus Armbruster wrote: > "What can we cut" is the wrong question. The right one is "what are our > requirements". Here's my try: > > HTML: required > nroff with an macros: required > PDF: wanted (try printing a website) > plain text: nice to have (for me personally

Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project

2017-01-26 Thread Markus Armbruster
Peter Maydell writes: > On 26 January 2017 at 17:52, Paolo Bonzini wrote: >> - HTML is mostly a destination format. With the listed formats it is >> possible to produce a variety of outputs (mostly HTML itself and PDF; >> secondarily text or ePub or others). > > It's an interesting question to

Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project

2017-01-26 Thread Cornelia Huck
On Thu, 26 Jan 2017 18:30:46 +0100 Paolo Bonzini wrote: > On 26/01/2017 18:28, G 3 wrote: > > > > On Jan 26, 2017, at 12:00 PM, qemu-devel-requ...@nongnu.org wrote: > > > >> > >> Hi all, > >> > >> as you may know I've been collecting some ideas about documentation for > >> QEMU at http://wiki.q

Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project

2017-01-26 Thread Peter Maydell
On 26 January 2017 at 17:52, Paolo Bonzini wrote: > - HTML is mostly a destination format. With the listed formats it is > possible to produce a variety of outputs (mostly HTML itself and PDF; > secondarily text or ePub or others). It's an interesting question to ask what destination formats we

Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project

2017-01-26 Thread Paolo Bonzini
On 26/01/2017 18:40, G 3 wrote: > > On Jan 26, 2017, at 12:30 PM, Paolo Bonzini wrote: > >> >> >> On 26/01/2017 18:28, G 3 wrote: >>> >>> On Jan 26, 2017, at 12:00 PM, qemu-devel-requ...@nongnu.org wrote: >>> Hi all, as you may know I've been collecting some ideas about docu

Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project

2017-01-26 Thread G 3
On Jan 26, 2017, at 12:30 PM, Paolo Bonzini wrote: On 26/01/2017 18:28, G 3 wrote: On Jan 26, 2017, at 12:00 PM, qemu-devel-requ...@nongnu.org wrote: Hi all, as you may know I've been collecting some ideas about documentation for QEMU at http://wiki.qemu-project.org/Features/Document

Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project

2017-01-26 Thread Paolo Bonzini
On 26/01/2017 18:28, G 3 wrote: > > On Jan 26, 2017, at 12:00 PM, qemu-devel-requ...@nongnu.org wrote: > >> >> Hi all, >> >> as you may know I've been collecting some ideas about documentation for >> QEMU at http://wiki.qemu-project.org/Features/Documentation. >> >> I've now prepared a poll to

[Qemu-devel] Qemu-devel] Poll on QEMU documentation project

2017-01-26 Thread G 3
On Jan 26, 2017, at 12:00 PM, qemu-devel-requ...@nongnu.org wrote: Hi all, as you may know I've been collecting some ideas about documentation for QEMU at http://wiki.qemu-project.org/Features/Documentation. I've now prepared a poll to understand how familiars developers are with variou