On Mon, 20 Jan 2025 at 01:56, brian m. carlson <sandals@xxxxxxxxxxxxxxxxxxxx> wrote: > > We presently use the ".txt" extension for our AsciiDoc files. While not > wrong, most editors do not associate this extension with AsciiDoc, > meaning that contributors don't get automatic editor functionality that > could be useful, such as syntax highlighting and prose linting. > > It is much more common to use the ".adoc" extension for AsciiDoc files, > since this helps editors automatically detect files and also allows > various forges to provide rich (HTML-like) rendering. Let's do that > here, renaming all of the files and updating the includes where > relevant. Adjust the various build scripts and makefiles to use the new > extension as well. Hi Brian. How about also renaming SubmittingPatches to SubmittingPatches.adoc? This is AsciiDoc according to 049e64aa50 (Documentation: convert SubmittingPatches to AsciiDoc, 2017-11-12).