Le 09/04/2021 à 06:02, Firmin Martin a écrit : > This patch series aims to make the documentation fully compliant to the > CodingGuidelines regarding monospace font. After it, new contributors > who just want to change a little portion of the documention could just > look around how it has been done without being confused by the > inconsistency between the documentation and the CodingGuidelines. Thank you for tackling the task of formating the docu and directing to CodingGuidelines for some markup rules. It appears that the last rule about backticks is wrong with late Asciidoctor, for which backticks are only a font switcher and no longer hold any semantic meaning. This means that double-hyphens may need escaping (see: https://asciidoctor.org/docs/migration/#migration-cheatsheet) when switching style and tools. One other rule worth adding would be that tabs are banned from asciidoc because they cannot always be matched with correct indentation.
