Re: RFC: Keeping board documentation in the boards and in the website at same time

2023-01-18 Thread Brennan Ashton
On Wed, Jan 18, 2023, 7:14 PM Nathan Hartman wrote: > Is there a way to facilitate both? > > That is, on the one hand, centralize the documentation in the nuttx > repository's Documentation directory so it can be modern and avoid > duplication, while at the same time facilitating the terminal usa

Re: RFC: Keeping board documentation in the boards and in the website at same time

2023-01-18 Thread Nathan Hartman
Is there a way to facilitate both? That is, on the one hand, centralize the documentation in the nuttx repository's Documentation directory so it can be modern and avoid duplication, while at the same time facilitating the terminal usage suggested by Alan? For example, is it possible to compile t

Re: RFC: Keeping board documentation in the boards and in the website at same time

2023-01-18 Thread Brennan Ashton
I would like to just move to the documentation section. There is way too much duplicate out of date common information in the existing readme. The new documentation has the ability to actually link things. Also CI is smart and will only build documentation and not all of the builds if you make ch

RFC: Keeping board documentation in the boards and in the website at same time

2023-01-18 Thread Alan C. Assis
Hi Everyone, As some have noticed some boards still have their README.txt in their original places: boards/arm/stm32/stm32f4discovery/README.txt boards/arm/rp2040/raspberrypi-pico/README.txt boards/x86_64/intel64/qemu-intel64/README.txt boards/risc-v/qemu-rv/rv-virt/README.txt boards/sim/sim/sim/