Re: [PATCH v6 18/18] docs: add Orange Pi PC document

[Peter Maydell]

On Mon, 9 Mar 2020 at 19:38, Niek Linnenbank <address@hidden> wrote:
> On Mon, Mar 9, 2020 at 12:22 PM Peter Maydell <address@hidden> wrote:
>> 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.
>
>
> OK, I'll move orangepi.rst to docs/system/orangepi.rst and add a short section
> about the Orange Pi PC machine to docs/system/target-arm.rst as well.

You should include/reference the orangepi.rst from target-arm.rst, I think --
that's where the per-board docs would belong in the structure we have.
If you just drop a .rst file into the docs directory somewhere it won't
actually go into the documentation and instead Sphinx will error
out about it not being in the table of contents anywhere.

(I'll have a look at microvm.rst to see how best to make the structure
work -- at the moment it kind of assumes there board documentation
is always quite short so they're all in one file.)

thanks
-- PMM