Re: [PATCH] docs: add AGENTS.md as a symlink to README

[Antheas Kapenekakis]

On Wed, 7 Oct 2026 at 10:52, Sasha Levin <sashal@xxxxxxxxxx> wrote:
>
> On Tue, Sep 29, 2026 at 06:10:42PM +0200, Antheas Kapenekakis wrote:
> >The kernel forces you to have a local version file, otherwise it adds
> >a .test wart. At least on Fedora. So there is precedent for requiring
> >the user to create a file to disable some default behavior.
> >
> >Similarly, you swap this series into a two parter.
> >
> >The first patch gitignores agents.md.
> >
> >The second patch adds a phony rule to the makefile that symlinks
> >agents.md to the coding assistants rst or similar if it does not
> >exist. People that do not want that, like me, touch that file. Not to
> >the current readme, please. Be reasonable. Yes the coding assistants
> >rst file is not ideal either but that can be fixed later.
>
> But then you would need to run make to "generate" the symlink, which would not
> normally happen.

We would make the dependency part of a basic rule, so it runs whenever
someone e.g., compiles a kernel. Yes a naked checkout would not have
it, but after an initial make it would appear.

Something like:

AGENTS.md:
  ln -s Documentation/process/coding-assistants.rst AGENTS.md

basic-dependency: ... AGENTS.md

This would cause the file to be created only if it does not exist.
since : is empty afterwards, the rule only runs when AGENTS.md does
not exist and does not replace any existing ones.

Best,
Antheas

> --
> Thanks,
> Sasha
>