Yes, I have a good idea of how translations could be managed
It depends what you want to translate. Currently we have the following websites for documentation:
SAFE Network Wiki
The SAFE Network Wiki has barely been updated for more than a year. A lot of the content is outdated and I think we should have a discussion about whether we want to continue using MediaWiki. I personally prefer static websites, they are a lot of easier to maintain and I think it’s essential to have the ability to accept pull requests. That way, anyone can easily suggest improvements, and discussions about improvements happen in a very open and transparent way (e.g. in the comments of a pull request).
One of the reasons for switching from GitBook to MediaWiki was that GitBook wasn’t ideal for FAQs. But now they have a theme made specifically for FAQs, so I think it would make sense to create an FAQ site that would look something like this: https://help.gitbook.com.
Another reason was that MediaWiki has good support for translations. Previously we were trying to manage multiple GitBook translations using the same GitHub repo. I think a better strategy would be to have one GitHub repo per translation. There is not much advantage to having all the translations in one repo. I feel it would be much easier to manage the translation process if each group of translators focus on their own repos (that way each group can self-manage and doesn’t necessarily have to get its changes approved by the authors of the original English version).
I am currently testing this process with @nbaksalyar. He translated the first Dev Tutorial in Russian (ru.tutorials.safedev.org) using this GitHub repo.
So I wouldn’t recommend working on translating the wiki right now, since the content will likely change a lot and we might even decide to use another tool (e.g. GitBook). I’m currently busy with the Dev Tutorials and the API Docs, so I can’t really focus on the wiki right now. Once I’m less busy, I could write a proposal and present an example FAQ site
Readme.io is currently used for user documentation (SAFE Launcher and SAFE Demo App). Previously it was also used to host the API Docs, but we recently rewrote them using GitBook. Readme.io makes it hard to have multiple users working on the same documentation compared to simply using a GitHub repo. I think it would be worth it to completely move away from readme.io at some point. We could host the user documentation using a static website. I have a few ideas related to how it could be organized and how translations could be managed, but it’s something I’m planning to work on later. I think it’s fine to continue using readme.io for the short term
Dev Tutorials
The Dev Tutorials were built using GitBook and it’s easy for anyone to contribute by submitting a PR to this GitHub repo.
I can also create a new GitHub repo for each translation.
There is still a lot of work that could be done to improve the existing tutorials. I’m not sure it’s worth focussing on translating them just now. I think it would be worth waiting until all the tutorials have been released before considering translating them.
API Docs
The API Docs are also built using GitBook. See this GitHub repo.
We haven’t written the documentation for Launcher API v0.6 yet (I’ll start working on it soon, maybe next week). I think it would be preferable to wait at least until Launcher API v0.6 has been documented before considering translating the API Docs