New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
x/tools/godoc: support multiple languages #32743
Comments
Can you explain what is "autoloading doc files" ? Your link does not work for me. Are you suggesting that we should add translations for multiple languages, or just the ability for godoc to show comments from different languages ? How do you propose these new language strings be stored ? |
hi @agnivade, updated the link. forgot to add https://
|
This feature is important for teaching millions of non English speakers all around the world. Perhaps godoc could accept for every .go file there could be additional .go.doc files in a doc/language_code subdirectory with the translations of the documentation for that language. The format could be something like the comments extracted from the normal go file, keyed by the first words. |
@agnivade Seeing the need for this felt by several of our users in China, as well as my own needs as a non native English speaker, I think this issue should be given more priority. Currently it is too hard to use godoc to translate the Go documentation. |
I am not exactly sure what you mean by "given more priority". This is an open issue and anybody is free to work on it. I am in no position to assign tasks to the Go team. But I will ping @dmitshur to check if this is something that can be brought under his radar. On side note: #22171 also tackles the |
OK, thanks for notifying the right people and for the link. |
What version of Go are you using (
go version
)?What did you expect to see?
currently when you write some comments in go code, godoc will generate a doc. this is very simple and straight. but i think this is like ascii only for english speakers.
last weekend. a friend ask me for some go chinese documentation. i found there is no official documentations, there are translations, but it's complete, or maybe outdated.
for translations. one way is to for golang/go, translate in *.go source code. this is hard to keep up with upstream. another way is hacking godoc, add autoloading doc files like this repo ....
this is not urgent but a nice to have feature. there are many more important things to do, but this should be taken it into consideration at least.
The text was updated successfully, but these errors were encountered: