On Sat, Aug 29, 2026 at 4:48 AM Dawid Weiss <[email protected]> wrote: > > This looks great, I think we should do a similar thing. Also, we should add > some global instructions for LLMs > to guide people's efforts and ensure they run all the checks prior to > contributing anything (some of this > is under help/ but a top-level AGENTS.md would help here).
Agreed. I also think maybe we should re-evaluate the help/ files becoming markdown format? Main reason would be to take advantage of markdown tooling. Our markdown linter will find broken links, the formatter will keep them tidy, its easier for developers to navigate between the files, etc. Would make the maintenance of these files easier. >> >> If nobody is opposed to the idea, maybe we can open a PR with 3 or >> lines of text similar to one of those examples? Maybe we could improve >> issue/PR templates to link to it. It might improve the signal-to-noise >> ratio. > > > +1. PR: https://github.com/apache/lucene/pull/16583 --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
