Docs: Hebrew version - Githubissues

bergden-resonai commented 1 year ago

I'm starting to work on the Hebrew translation of the docs, will start with the manual parts. It's awesome there's already Arabic translations as most rtl-related stuff are already handled well, I'll fix some more RTL stuff on the way - I'm not an Arabic speaker so would love another set of eyes on these changes to make sure they make sense (I'll also validate with a colleague).

mrdoob commented 1 year ago

We currently have a problem with documentation translations: https://github.com/mrdoob/three.js/issues/24984

bergden-resonai commented 1 year ago

Thanks for the update - I saw this thread when I started and saw it coming, and honestly haven't made much progress because I kept putting this off in favor of fixing the links/unicode stuff (and general business of life) - I have a branch ready with most of the "Getting started" section, but I think I'll wait for this thread to resolve

My 2 cents: The translation is much harder than expected:

A lot of the technical language doesn't necessarily have an obvious counterpart in Hebrew
The LTR/RTL issues are quite hard to deal with
I spent a lot of time trying to bypass having to translate inside the HTML - which makes formatting considerations very hard to deal with (especially with the LTR) So I definitely think having some i18n solution implemented first will make this work easier

Also a lot of the docs around "Getting started" seem quite outdated - and I assume that since I started I already have big gaps I'll need to try and find somehow

mrdoob / three.js

Docs: Hebrew version #25098