www.ziglang.org icon indicating copy to clipboard operation
www.ziglang.org copied to clipboard

Is it possible to consider adding translations for the latest stable version of the documentation?

Open C-BJ opened this issue 3 years ago • 11 comments

C-BJ avatar Jan 27 '22 07:01 C-BJ

which page do you mean?

alichraghi avatar Jan 27 '22 07:01 alichraghi

which page do you mean?

https://ziglang.org/documentation/0.9.0/ and https://ziglang.org/documentation/0.9.0/std/

Of course the versions can be different, but I don't think master needs to be translated

C-BJ avatar Jan 27 '22 08:01 C-BJ

I do not understand why https://ziglang.org/documentation/0.9.0/ and https://ziglang.org/documentation/0.9.0/std/ have a different appearance

C-BJ avatar Jan 27 '22 08:01 C-BJ

currently i disagree with the translation of documention. because the concepts and words are very simple and it's expected the programmer know this words. there is also no guarantee that the people who wrote the translation of the previous pages will be willing to do so and this isn't possible due to the small community

alichraghi avatar Jan 27 '22 08:01 alichraghi

currently i disagree with the translation of documention. because the concepts and words are very simple and the programmer is expected to know this words. there is also no guarantee that the people who wrote the translation of the previous pages will be willing to do so and this isn't possible due to the small community

The translation of the document is really big, but unlike the translation of the first few pages, the document can be partially localized and the rest remains in English. I also agree with you that translation may not be necessary, but I think it's only a matter of time

C-BJ avatar Jan 27 '22 08:01 C-BJ

there is no latest stable version

nektro avatar Jan 27 '22 11:01 nektro

there is no latest stable version

I mean the version with the version number, not the dev (master) version.

Learn page say that 0.9.0 is Latest Stable

C-BJ avatar Jan 27 '22 12:01 C-BJ

its the latest release, not the latest stable. i'll open an issue to have the copy fixed

nektro avatar Jan 27 '22 13:01 nektro

its the latest release, not the latest stable. i'll open an issue to have the copy fixed

It doesn't hurt that,I just want to say that the version to be translated should have a version number, not the development (main) version.

C-BJ avatar Jan 27 '22 14:01 C-BJ

its the latest release, not the latest stable. i'll open an issue to have the copy fixed

If version 1.0 comes, will the page have to be changed again?

C-BJ avatar Jan 27 '22 14:01 C-BJ

@C-BJ are you interested in contributing a translation for the language reference? Or are you asking more in general?

The documentation for the standard library can't be translated because it's autogenerated and the current system that we use to autogenerate them is about to be scrapped in favor of a new one. Even then, these docs are based on the actual comments in the source code, translation seems hard do to, and easy to go out of sync.

The language reference changes less often and since it's hand-written, translating (and keeping track of changes), seems more feasible. That said, I honestly think that it might be better to wait and translate a better learning resource than the language reference. A better learning resource would be something like Zig Learn or a Zig book.

kristoff-it avatar Jan 27 '22 21:01 kristoff-it