He @peaceiris and thanks for you interest in Hugo.
In my opinion, every translated version of the Hugo documentation should be hosted on gohugo.io (or: the same host). We added multilanguage support in Hugo for a reason. We should use it. This is important.
Now, this has proven to be hard to do in practice, but we should really, really try to get there. My problem is that I cannot merge languages I don’t understand. @anthonyfok is the editor of the Chinese translation, but he’s busy, so that is a bottleneck …
I want us to come up with a better way of doing this. Maybe the Japanese content can live in its own Git repo and we pull it in as a submodule? That way we say that we “trust it by default”, and if we get reports telling us that we should not, we remove it. Then the communities for the different languages can be their own editors.
In my opinion, every translated version of the Hugo documentation should be hosted on gohugo.io (or: the same host). We added multilanguage support in Hugo for a reason. We should use it. This is important.
I think so!
I hope that the Japanese version is also hosted on gohugo.io
Now, this has proven to be hard to do in practice, but we should really, really try to get there. My problem is that I cannot merge languages I don’t understand. @anthonyfok is the editor of the Chinese translation, but he’s busy, so that is a bottleneck …
This is a common problem for OSS projects. To solve it, we have to gather many contributors to share tasks and improve precision of translation. I think that the number of contributors will increase as the Japanese translation project starts. Of course, I will try gather contributors.
I want us to come up with a better way of doing this. Maybe the Japanese content can live in its own Git repo and we pull it in as a submodule? That way we say that we “trust it by default”, and if we get reports telling us that we should not, we remove it. Then the communities for the different languages can be their own editors.
Submodule! It is good idea!
In this case, should Japanese community manage only content/ja as a repo?
That was my thought, yes. This repo could live in the gohugoio organization, but it would solve the biggest practical problem in that I wouldn’t have to give commit access to the main hugoDocs repo to a lot of people that I don’t know. This way “you” could edit/translate as you please, and we could merge when suitable.
There are probably some practical issues with the workflow above, but they should be solvable.
Maybe there are other contents that should be localized besides the above two. So, each translation project has to commit to gohugoio/hugoDocs for these contents.
As far as I know Hugo doesn’t version their documentation so unless there’s a process set-up for crowdsourcing, it might be difficult to keep the docs up to date in Japanese and have them match the current docs over time.
I think so. Now, we can translate only the latest version of Hugo. In the future, official documents should have version.
In this case, https://kubernetes.io/ is useful for us. It has multi languages and versions. (It is managed by Hugo)