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

[Peter Maydell]

On Wed, 4 Mar 2020 at 20:55, Niek Linnenbank <address@hidden> wrote:
>
> Hello Alex,
>
> On Wed, Mar 4, 2020 at 11:35 AM Alex Bennée <address@hidden> wrote:
>>
>>
>> Niek Linnenbank <address@hidden> 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