"Localizing docs in Sphinx": the guide that shows how to use sphinx-intl and other tools to localize documentation created with Sphinx. http://sphinx-intl.geekwriter.ru/en/
MIT License
2
stars
0
forks
source link
Discuss: Extend guide with other translation repository strategies #2
During the searches that led me to discover this nice guide, I found that there were at least two other translation repository strategies used by sphinx-doc projects, aside of the 'mono-branch' one described ATM:
Dual branch: translations are maintained in a separate, translation dedicated, branch.
I have to make a second pass to grasp the pros of this one and see if some use language specific branches.
Dual repo: translations are maintained in a separate repo.
Major pro of this strategy is avoiding cluttering the main repo history with translations commits.
Again, I have to dig deeper to get all the pros and cons.
If you don't mind, I'll announce publishing of this guide source and RFC to this in the few most significant issues where I've found the guide mentioned :)
authoress
commented
1 year ago
Hi,
During the searches that led me to discover this nice guide, I found that there were at least two other translation repository strategies used by sphinx-doc projects, aside of the 'mono-branch' one described ATM:
If you don't mind, I'll announce publishing of this guide source and RFC to this in the few most significant issues where I've found the guide mentioned :)
Thanks again for sharing this TY J