On Sun, May 14, 2023 at 7:44 PM Gregory Nutt <spudan...@gmail.com> wrote:
> > > On 5/14/23, Brennan Ashton <bash...@brennanashton.com> wrote: > >> Before I do more work to wire this up, please let me know if this pdf > >> I have attached here seems like a reasonable start for people > >> https://github.com/apache/nuttx/issues/9095#issuecomment-1547008998 > >> > >> It is basically the same content on the website, so missing > >> information is out of scope of this change, > >> but I don't want to fix some compatibility issues here unless people > >> actually think this is of value. > >> > 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. It does look very good for starters! Of course there are a lot of omissions right now but that is OK right now because it is generated from Documentation in the repo, which contains a lot of omissions... I think that having the docs in the form of a book or PDF allows us to see the structure of the documentation more easily and therefore we can write better documentation. I recommend to keep it as automatically generated from Documentation in the repo because that will reduce duplication of effort. When we improve Documentation, we will automatically improve the website and the PDF book. There are many "easy" areas to fix and improve. For example, the section of supported architectures lists only a few while in truth we support a lot more. But as Brennan said, we're not talking about omissions right now. :-) 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? That would be a neat idea! Maybe we could reach out to some professional technical writers and find out if they'd like to take on the project and publish a professional (for sale) book. The first author that comes to mind, just off the top of my head, is Derek Molloy, the author of books like Exploring Raspberry Pi [1] and Exploring BeagleBone [2]. Both of these are about embedded systems. Both of these include tutorials not only in electronics (how to use FET transistors, for example) and embedded systems (how to use GPIOs and not blow up your board) but also higher level topics in Linux, since both boards run Linux distros by default. (Side note: I would love to see these boards run NuttX!!) So this author is no stranger to electronics, embedded, coding, and POSIX systems. It might sound like a fabulous idea but unfortunately I have no idea how one would reach this author to ask!! If someone knows, please do it!! [1] https://a.co/d/5S3Etz0 [2] https://a.co/d/avmNiH7 Cheers Nathan
