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

[Julien Fischer]

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.

By the way, we could also replace the HISTORY file with a HISTORY directory,
> with one file per major release. That would make a grep for e.g. a
> predicate name
> more useful, as grep will tell you immediately which release the match is
> for,
> without needing to look in the file for the immediately previous major
> release heading.
> Do you guys agree with doing this?
>

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

Julien.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.mercurylang.org/archives/developers/attachments/20251218/f404e46d/attachment.html>