[m-dev.] Shifting README files into a subdirectory

[Zoltan Somogyi]

On Thu, 18 Dec 2025 12:10:35 +1100, Julien Fischer <jfischer at opturion.com> wrote:

> On Thu, 18 Dec 2025 at 11:42, Zoltan Somogyi <zoltan.somogyi at runbox.com>
> wrote:
> 
> >
> > On Wed, 17 Dec 2025 17:21:20 +1100, Julien Fischer <jfischer at opturion.com>
> > wrote:
> > > Zoltan suggested moving all but the main README file into a subdirectory
> > > some time ago.
> >
> > Obviously, I approve.
> >
> > > I propose we name the new subdirectory "guides" and make
> > > this change.
> >
> > I would propose something like READMES, READMES.x or
> > READMES.system_specific
> > for the name of this directory, just to make clear that it contains more
> > README files.
> >
> 
> I avoided READMES, readmes etc because there will still be a file called
> README.md at the top-level.

I don't understand the logic of that statement. You are objecting to a directory
full of files named README.x for some x, all of whose names are related to README,
itself having a name related to README? That is like objecting to "truth in advertising".

Peter, if you object to names such as READMES, do you have a proposal for a name
that you like better?

> No objection from me. Obviously the parts of the existing HISTORY file that
> are Markedown
> could be placed in .md files within that directory.

Agreed.

Zoltan.