Skip to content

[Proposal] Documentation Translation Strategy #21926

@Hebilicious

Description

@Hebilicious

Motivation

Vue is a very international community with a lot of presence in non-english regions like China.

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.

image

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

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions