Re: "staging" area for unsorted random files under Documentation/*.rst

[Jonathan Corbet <corbet@lwn.net>]

On Tue, 18 Feb 2020 14:26:14 +0200
Jani Nikula <jani.nikula@linux.intel.com> wrote:

> On Tue, 18 Feb 2020, Mauro Carvalho Chehab <mchehab+huawei@kernel.org> wrote:
> > Shifting those around is not easy (I tried a few times), as some discussions
> > are required in order to get them at their rightful places.
> >
> > So, my current proposal is to just rename them to *.rst, keeping them
> > where they are, and adding them into an "staging" area at the main
> > index.rst. See the enclosed patch.  
> 
> The obligatory bikeshedding comment, how about adding an actual
> "staging" directory under Documentation, perhaps with an index.rst of
> its own?

I kind of agree, actually.  If we absolutely must create a trashpile of
random documents, the top-level directory seems like the worst place for
it.  Let's hide our shame rather than rubbing everybody's nose in it.

> Personally I don't really mind having .txt files around either, just
> *not* at the top level Documentation directory.

In general, RST conversion is not my highest priority at this point.
There is only so much value in creating a more nicely formatted version
of an unorganized heap of obsolete documentation.  Hopefully we get get a
bit more focus on quality once this is all behind us...

Thanks,

jon