On Mon, May 15, 2023 at 1:44 AM Gregory Nutt wrote: > Over the years, there have been several people with the dream of writing > a commercial, NuttX book in the spirit of the famous uC/OS book. There > were even a few starts but all gave up when the magnitude of the effort > sunk in. > > But this looks like a good begubbubg. It looks like a book.
This is just Sphinx output to PDF in addition to HTML that I was talking about some time ago giving Kivy docs as an example :-) > How much additional effort would it take to develop a book (like an > O'Reilly book) or a free eBook on Amazon or Google Books? Well this is in fact the current nuttx.git/Documentation. It needs to be cleaned up and developed to become "the book" we want. Then it can be published not only on the project website but also web stores for free and maybe for purchase in order to support the project development :-) Sphinx offers following output formats: html (standalone, directories, singlepage), pickle, json, html help, qt help, dev help, ePub (!!), LaTeX/PDF (!!), text, man, texinfo, info, gettext, xml. Virtually anything can be created and/or converted to. PDF and ePub seems most common online book formats nowadays. > To bad we don't have a technical writer on the team. I will try to help in this area. But first I need to get really good familiarization myself with the details (this will take some time sorry). Any technical writer would have to go along that path too :-) I am thinking about step-by-step introduction based on real world examples that would provide recipes ready for use for people like me :-P I really love to work with PDF Handbooks. Thank you Brennan for making the first step a reality!! :-) -- CeDeROM, SQ7MHZ, http://www.tomek.cedro.info
