On Wed, Dec 18, 2019 at 12:01 PM Gregory Nutt <spudan...@gmail.com> wrote: > There is this: http://www.nuttx.org/doku.php?id=wiki:getting-started > where the "external tutorials" is quite extensive: > http://www.nuttx.org/doku.php?id=wiki:getting-started:external-tutorials
That's great but I think we need our own basic Getting Started guide that gets a total newbie off the ground quickly; it can, of course, have an "Additional Resources" section with links to all of these other resources. On Wed, Dec 18, 2019 at 12:31 PM Abdelatif Guettouche <abdelatif.guettou...@gmail.com> wrote: > Boards readme files contain all the information needed to get started > with a particular board. Again, that's great, but it presumes that you have the code, know about the board READMEs, know where they are... I'd prefer that the Getting Started guide should be reachable by one click from the front page of the NuttX website (which doesn't exist yet), so that a TOTAL newbie who hasn't even gotten the code yet can read and get a feel for what's involved. Yes, much of the information is in the README file. Perhaps we can modify text files like that to be in Markdown format, which unlike HTML, leaves the file looking like a normal ASCII file, but allows the file to be converted to other formats, including HTML, using automated tools. Then we could convert that information and display it directly on the website. Nathan
