-
-
Notifications
You must be signed in to change notification settings - Fork 5.6k
[Proposal] Documentation Translation Strategy #21926
Description
Motivation
Vue is a very international community with a lot of presence in non-english regions like China.
- Many community members have proposed their help here Documentation translations #16054
- China have a (non-official ?) Chinese version of the Nuxt docs We plan to build a Chinese mirror site. #16208 : https://nuxt.com.cn/\
- A Russian translation has been discussed Russian translation #17351
- A Ukrainian translation have been discussed Documentation translation #19926
Formkit recently released an AI translation for their website docs https://formkit.com/ in 4 languages.
We could take a similar approach and combine it with the existing community translations.
In my opinion, an AI approach needs to be compatible with existing contributions, and manual modifications.
Implementation idea
Disclaimer: I'm sharing some of my thoughts about how we could build such a system, to gauge community interest in doing so. Suggestion and feedback would be very appreciated!
We would use i18n for the docs website to handle the language strings (related docus issue nuxt-content/docus#770)
Then to keep the translations in sync with the english source, we could run logic (maybe within the CI), that is triggered when english docs gets merged in nuxt/nuxt, and automatically open PRs for each language with a LLM translation inserted at the right location.
With such a system, the Nuxt community/team can review the LLM output and modify it before merging it for their language.
All new additions to the docs must be done in English, so that they are reflected anywhere.
If translations PRs are an issue for maintainers, we could move all of this to another repo nuxt-international or something.
Many of the Nuxt/Unjs team members already speak 2 or more languages, so we could start out with these languages.
If this system is successful, it can be expanded and applied to other things, such as the UnJS ecosystem, or integrated with docus
Create entire translations from scratch
While working from human written translation is more accurate, we could also experiment with entirely AI written translations. We could build a tool that translates all markdown docs content from the english source into a new language.
Bonus
Look at worldwide trends for Nuxt over the last year : https://trends.google.com/trends/explore?q=nuxt,nuxtjs,nuxt.js&hl=en-GB
Interestingly enough, there's more search interest for Nuxt in China than in english speaking countries.
In fact, the anglosphere rank significantly lower than other areas.
Additional information
- Would you be willing to help implement this feature?
- Could this feature be implemented as a module?
Final checks
- Read the contribution guide.
- Check existing discussions and issues.