Michael Käppler <xmichae...@web.de> writes: > Hi Jean, > > Am 12.09.2020 um 13:28 schrieb Jean Abou Samra: >> Hi, >> >> Towards the end of the process, `make doc` outputs warnings coming >> from fix-docsize.sh. This occurs in CI too. Any ideas? >> >> Best, >> Jean > > IIUC this is simply due to the fact that the mentioned manuals are not > translated and therefore > are missing in the doc tree. Since fix-docsize.sh cannot determine the > size of files that don't exist, > it outputs this message. > > The more important issue seems to me that the missing translations cause > many broken links in the documentation.
The reason fix-docsize.sh gives those warnings is to help diagnosing those broken links. > Was this always the case? It came with some doc reorganisation. The offline docs were broken for a long time. The online docs might or might not have worked depending on the language settings in your browser (via Apache redirection configuration), and it would be very hard to browse through documentation in a language that wasn't first choice in your browser: this frequently cast you back into some other language. > I think these should links should either be removed or point to the > english version with an adjusted link text like > 'Changes (no translation available)' The whole language selection thing is completely broken. Only the landing page should look at your browser language selection; afterwards all links should stick with the selected language. Of course the problem with that is that this should not be the case for an English-language fallback. Strictly speaking, those should not be the same as the normal English-language pages but rather be per-language copies that have all links changed to stick within the language that is missing the page translation. -- David Kastrup
