On Tue, 18 Feb 2020 14:26:14 +0200 Jani Nikula <jani.nikula@xxxxxxxxxxxxxxx> wrote: > On Tue, 18 Feb 2020, Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx> 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
