translated docs

[Stefan]

I was going through the translations.

While the translations for the UI are mostly ok, the ones for the docs are not:

• most are incomplete (only 3 are fully translated)
• many also translate command line arguments or other strings that must not be translated
• some use invalid escaping, leading to severe layout issues
• some don't update changed strings correctly, leaving old (and therefore wrong) texts in the translation
• also it happens regularly that I have to fix translated strings because of mismatched open-and-closing tags (in that case the build fails)

So, considering all the problems I was wondering whether we really need the docs to be translated? The UI translation would of course stay. But If there are no objections, I would remove the translated docs with the next release and only leave the docs in English.

On a sidenote: has anyone of you even used the translated docs? Or do you use the English ones?

Stefan

[Daniel Sahlberg]

torsdag 22 juli 2021 kl. 13:34:37 UTC+2 skrev Stefan:

I was going through the translations.

While the translations for the UI are mostly ok, the ones for the docs are not:

• most are incomplete (only 3 are fully translated)
• many also translate command line arguments or other strings that must not be translated
• some use invalid escaping, leading to severe layout issues
• some don't update changed strings correctly, leaving old (and therefore wrong) texts in the translation
• also it happens regularly that I have to fix translated strings because of mismatched open-and-closing tags (in that case the build fails)

So, considering all the problems I was wondering whether we really need the docs to be translated? The UI translation would of course stay. But If there are no objections, I would remove the translated docs with the next release and only leave the docs in English.

I've been meaning to take a look at the translation to Swedish (and I have done some bits and pieces) but I must admit that it is quite low on my list of priorities, definately behind working on the code. While in principle I think it is nice to have localized manuals, considering your points (especially 1 and 4), I think it is a correct decision to remove the translated docs.

On a sidenote: has anyone of you even used the translated docs? Or do you use the English ones?

I would use the English, especially since it is easier to ask questions *here* using the correct terminology instead of trying to guess the correct term for #insert localized term#.

Kind regards,

Daniel Sahlberg

[Daniel Sahlberg]

Coming back to an old thread: The tools used to produce the translated manuals require Python2 and a binary library that is no longer available, without these it is impossible to build TortoiseSVN. This makes it difficult to add new contributors. Considering there has not been any replies to this thread, I've made a suggestion on the Tortoise-Dev group to remove the translated User manuals (see [1]).

This will not affect the language packs for the user interface.

If anyone would like to keep the translated documentation, speak up and please be prepared to help out migrating the scripts to Python3.

Kind regards,

Daniel Sahlberg

[1] https://groups.google.com/g/tortoisesvn-dev/c/6V0DMV_0RGI