On 31.07.2024 at 23:13, Rowan Tommins [IMSoP] wrote: > On 30/07/2024 20:15, Tim Düsterhus wrote: > >> Part of the motivation of the deprecation (and my argument against the >> addition of a standalone sha256() function) is simplifying the >> documentation: Everything needs to be written down in multiple >> different places, any changes to hash_file() will likely also need to >> be applied to md5_file() and sha1_file() - and then it will need to be >> translated. > > We already have a solution for this: named snippets (implemented as XML > entities), which exist in the source once, are translated once, and then > inserted into every page that applies when it's rendered to HTML.
These entities are of limited use, though, since they are not parametrizable, so you always get exactly the same text, and may need ugly workarounds to even use entities for reusable text snippets. And lots of entities can make the sources of the documentation pretty hard to read. Cheers, Christoph
