On Wed, Dec 18, 2019, 5:06 PM Justin Mclean <justinmcl...@me.com.invalid> wrote:
> Nhi, > > > This conversation got me thinking: would we want a repository to write a > > community-written-and-maintained NuttX book? > > > > I think this would have a couple of advantages: > > > > (1) Keeps the "official" documentation within the umbrella of the > project. > > > > (2) Provides an additional way for people to contribute to Apache NuttX. > > (Not all contributions need to be code; not all contributors need to be > > software people.) > > Excellent idea. You might want to look at what the Apache Training project > is doing or perhaps consider (if you have not) using asciidoctor. [1] > > Thanks, > Justin > > 1. https://asciidoctor.org I posted this previously but it got split between the mailing lists. This is actually an area where the Rust team has done an amazing job. There are several books both online and sometimes print that are up-to-date, covering both the intro and domain specific topics. https://doc.rust-lang.org/book/ https://doc.rust-lang.org/rust-by-example/ https://rust-cli.github.io/book/ https://rust-embedded.github.io/book/ Long as we do some form of markdown there are lots of options. gitbook, mdbook, Sphinx, etc... --Brennan
