On 2026/06/09 23:13, Volker Schlecht wrote:
> We may be able to reduce the risk of that happening by disabling the
> hash. It's intended as a cache busting feature which doesn't make sense
> for docs bundled with a package.

That doesn't even make sense for web-published files, because there's no
such hash in the filenames for .html.

Would it make sense to change the default for mdbook in ports to disable
the hash instead?

> Of course future versions of mdbook may still change the file names of
> the bundled default theme (or add / remove files), so the note is still
> needed.

usual issue with sphinx, doxygen, etc too, especially when generating
html docs. FWIW I often disable these unless the generated docs really
add something useful to the port. (manpages: usually want them. html
library docs: often more trouble than they're worth).