Source | alibaba cloud native public number

background

KubeVela V1.0 enables a new official website architecture and document maintenance. New features include document versioning control, i18N internationalization, and automated processes. However, currently KubeVela official documents are only in English, which improves the threshold of learning and using KubeVela, which is not conducive to the spread and development of the project. Meanwhile, translation work can also significantly improve the language ability and help us broaden the breadth of reading technical materials, so we organize this activity.

The event

The event was initiated by KubeVela Community and co-organized by OAM SIG, cloud Life community.

Active process

This activity is mainly carried out under Kubevela. IO repo, registration and claim tasks are registered in kubevela official document translation registration (please be sure to register information in the form).

Click to enter the registration form.

Start translating

The translation process

The basic process of participating in translation activities is as follows:

  • Task collection: register and claim tasks in KubeVela official document translation;
  • Submission: Participants submit PR for review;
  • Maintainer Reviews PR;
  • Final review: final confirmation of the content after review;
  • Merge: Merge into the master branch. End of the task.

Participate in the guide

The following is a detailed introduction of the specific work involved in translation.

1. Preparation

  • Account: You need to prepare a GitHub account first. Use Github to claim and submit PR for translation tasks;
  • Git remote add upstream github.com/oam-dev/kub…
  • Translate in your own warehouse, origin;
  • Create a branch for a task.
  • Node.js version >= 12.13.0 (you can run the Node -v command to view the version);
  • Yarn version >= 1.5 (you can run the Yarn –version command to view the version.)

2. Participation steps

Step 1: Browse tasks

Register in KubeVela official documentation translation and browse what tasks are available to claim.

Step 2: Task collection

Edit and claim tasks in the KubeVela official document translation registration form. Note: To ensure the quality, the same translator can only claim three tasks at the same time, after completion can continue to claim.

Step 3: Build and preview locally

$yarn run start -- --locale zh yarn run v1.22.10 Warning From yarn 1.0 again scripts don't require "--" for options to be forwarded. In a future version, any explicit "--" will be forwarded as-is to the scripts. $ docusaurus start --locale zh Starting the development server... ✔ Docusaurus website is running at: http://localhost:3000/zh/ Client Compiled successfully in 7.54 s ℹ "WDS" : Project is running at http://localhost:3000/ ℹ "WDS" : Webpack output is served from /zh/ ℹ "WDS" : The Content not the from webpack is served from/Users/saybot/own/kubevela. IO ℹ "WDS" : ✔ 404s will fallback to /index.html bookmark Client Compiled successfully in 137.94msCopy the code

, please do not modify the/docs directory content in Chinese documents/i18n/useful/docusaurus – plugin – content – docs, after can at http://localhost:3000/zh/ to preview.

Submit the PR

After confirming the completion of the translation, you can submit the PR. Note: to facilitate the translation of each review article into one PR, if you translate multiple articles, please checkout multiple branches and submit multiple PR.

Step 5: Review

Maintainer reviews PR.

Step 6: Complete the task

Qualified translations will be merged into kubevela. IO’s master branch for publication.