Skip to content

Translations guide #825

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Mar 8, 2021
Merged

Translations guide #825

merged 4 commits into from
Mar 8, 2021

Conversation

skirtles-code
Copy link
Contributor

@skirtles-code skirtles-code commented Jan 27, 2021

This PR attempts to introduce specific guidance for those who wish to embark on a translation of the Vue 3 documentation. While translators are free to make decisions about the best way to manage a specific translation, some general guidelines should help to avoid time being wasted. It also helps to set expectations about what is involved.

In addition, a list of 'Community Translations' is shown in a table on the main translations page. This should make it easier to find translations maintained by the community, without needing a translation to be complete or as actively maintained as an official translation. The decision about which languages to include in this PR was a little arbitrary. It looks like both French and Turkish have active translations that may soon be ready to add to the list. If the maintainers of those repositories are reading this and would like to be included then please open a PR to add your translation to translation-data.js.


Rendered: https://deploy-preview-825--vue-docs-next-preview.netlify.app/guide/contributing/translations.html

Copy link
Member

@NataliaTepluhina NataliaTepluhina left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@skirtles-code looks great to me!

Copy link
Member

@bencodezen bencodezen left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fantastic job with this @skirtles-code!

@skirtles-code skirtles-code marked this pull request as ready for review March 3, 2021 17:09
@skirtles-code
Copy link
Contributor Author

I'm now happy for this to be merged.

The commits I've just pushed make a few small changes:

  1. Incorporating the new Korean translation in the main translations menu.
  2. Adding a commented out link to the English translation in the main menu. This includes a note requesting that translation maintainers enable the link.
  3. Adding the <OutboundLink> marker to the links in the community translations table.

@bencodezen bencodezen merged commit 8188362 into vuejs:master Mar 8, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants