Re: [GNUnet-developers] proposal: changes to documentation

2018-09-16 Thread Christian Grothoff
On 09/16/2018 12:42 PM, Nils Gillmann wrote: > Christian Grothoff transcribed 8.3K bytes: >> Hi Nils, >> >> (1) our handbooks should be "real" books. For example, the GNU >> libmicrohttpd manual can even be ordered in print. We should strive for >> our documentation to be of book quality. >> >>

Re: [GNUnet-developers] proposal: changes to documentation

2018-09-16 Thread Nils Gillmann
Christian Grothoff transcribed 8.3K bytes: > Hi Nils, > > (1) our handbooks should be "real" books. For example, the GNU > libmicrohttpd manual can even be ordered in print. We should strive for > our documentation to be of book quality. > > (2) Texinfo is the offical documentation standard for

Re: [GNUnet-developers] proposal: changes to documentation

2018-09-16 Thread Nils Gillmann
Florian Dold transcribed 6.9K bytes: > I'm not the biggest fan of texinfo either, but it works. > > mandoc looks like a terrible replacement, and I strongly disagree with > your proposal of switching to it. > > When comparing the documentation of mandoc/mdoc > >