On Wed, 4 Mar 2020 at 20:55, Niek Linnenbank <nieklinnenb...@gmail.com> wrote: > > Hello Alex, > > On Wed, Mar 4, 2020 at 11:35 AM Alex Bennée <alex.ben...@linaro.org> wrote: >> >> >> Niek Linnenbank <nieklinnenb...@gmail.com> writes: >> > --- >> > docs/orangepi.rst | 226 >> > ++++++++++++++++++++++++++++++++++++++++++++++ >> >> I suspect there is a better place to put this is than the top level. I >> wonder if it should be docs/specs? > > > Yeah I'm fine to move it to a different subdirectory if needed. Right now its > placed in docs, > as it seems that documents for machines are also placed there, for example > docs/microvm.rst
The only things in the top level docs/ are a handful of legacy-ish files that went there because we didn't yet have a better place to put them. We should avoid increasing the number of orphan files in the top level (and indeed should try to move the existing orphans elsewhere). >> When Peter's document PR goes in later this week there will also be a: >> >> docs/system/target-arm.rst >> >> which would benefit from a section for the Orange Pi in it. Yes, this is now the right place to put arm board-specific documentation (the rearranging and conversion from texinfo is now in master). I should move microvm.rst's contents there I guess. thanks -- PMM
