Hello, Ignacio Encinas Rubio wrote: > On 12/3/25 23:36, Jonathan Corbet wrote: >> It would be best, of course, to get the memory-model documentation >> properly into our built docs...someday... > > I hadn't thought about this. If this sentiment is shared by the LKMM > people I would be happy to work on this. Has this ever been > proposed/discussed before? > This might be something Jon would like to keep secret, but ... See the message and the thread it belongs at: https://lore.kernel.org/lkml/Pine.LNX.4.44L0.1907310947340.1497-100000@xxxxxxxxxxxxxxxxxxxx/ It happened in 2019 responding to Mauro's attempt to conversion of LKMM docs. I haven't see any change in sentiment among LKMM maintainers since. Your way forward would be to keep those .txt files *pure plain text" and to convert them on-the-fly into reST. Of course only if such an effort sounds worthwhile to you. Another approach might be to include those docs literally. Similar approach has applied to Documentation/ atomic_t.txt atomic_bitops.txt memory-barriers.txt Regards, Akira