On Thu, Oct 15, 2026 at 3:57 PM Jonathan Corbet <[email protected]> wrote: > > For all that we hear about how smart these tools are, are they really > incapable of dealing with two only slightly different markup formats? I > would really hate to bring in a separate format for this stuff...
I think it would work fine in practice. But it means that we have to split every "skill" into two files (and reformat when we may want to move details from one to the other), unless I am missing something. So if we keep the files rendered and so on (possibly in `Documentation/`), and make use of `.rst` features etc., then I think it is worth doing it. If not, i.e. if we just use it as a place to "dump text", then I think Markdown may be simpler. Cheers, Miguel
