Docs: Italian version

[AngyDev]

Hello, I'm a software developer and a three.js user.

I'd like to contribute to the library and I think that the best way to start is by documentation. I'd like to translate the documentation into Italian.

What do you think? Is it possible?

[Mugen87]

That would be a great contribution! We have an issue per language (see #24375 or #14748) so I suggest to use this one for Italian.

It's best to file PRs for specific sections (e.g. "Manual" ,"Animation" or "Core") and not for individual pages. It would be also good to only add translated pages to the it folder and not the English ones as placeholders.

[AngyDev]

Great!! I can start with the Manual section. I create it folder for the translation.
Is it correct to start from the dev branch?

[Mugen87]

Is it correct to start from the dev branch?

Yes.

[AngyDev]

Thanks!
@Mugen87 I have a question, I saw that in the manual pages the title <h1>[name]</h1> is generated at the load of the documentation. Is it right to maintain the English name also for the Italian translation or can I translate it?

[Mugen87]

I would handle this use case similar to other translations. Meaning translating the titles but keep [name] in parentheses.

[AngyDev]

Hi @Mugen87!
Which is the next step? Is better to continue the translation with the reference section or with the fundamentals one?

[Mugen87]

I would continue with the API reference 👍.

[davidedemarco]

Is there any way I can help with this? I'm an italian sw developer and I'm getting started with three.js, it would be a great way to read the documentation and help out at the same time

[AngyDev]

Hi @davedema, if you want you can translate from the Addons section, for now, I stopped there. Every time you complete a subsection you do a PR, for example, if you translate Animations you do a PR, then Controls, and so on. That way we keep each other aligned on developments. What do you think?

[davidedemarco]

looks good! I will work on animations then

[mrdoob]

We currently have a problem with documentation translations: #24984

[AngyDev]

Hi @davedema!!! How is the translation of the animation section going? Are you still interested in doing it?