Indonesian Docs Translation for Kubernetes

This README is owned by sig-docs-id, a special interest group in Kubernetes community responsible for translating the entire Kubernetes docs into Bahasa Indonesia. This process is called localization. Through this README, we hope to onboard contributors who know Bahasa Indonesia to join our mission.

Why are we doing this?

Translation is sometimes a tedious work, so we need some motivation to do it.

• You will read the Kubernetes doc, and rewrite it with your own expression in Bahasa Indonesia. This forces you to understand the content of particular Kubernetes doc, and validate your understanding by explaining it in your own words.
• Reach wider audience in Indonesia who want to learn about Kubernetes and passionate about it, but cannot because of language barrier.
• Let the world know about our beautiful language Bahasa Indonesia.

Getting Started

Getting started for this docs-id project can be found in this slide. To summarize, the steps are:

1. Join #kubernetes-docs-id channel in Kubernetes slack. You can discuss and ask any questions here related to your contribution.
2. Kubernetes org requires you to sign CLA in order to contribute. Follow this guide if you haven't done so.
3. Look at Indonesian translation issue tracker to pick what page to translate.
4. Fork the kubernetes/website repo to your own Github account.
5. Make your changes in your own fork. Look for the content/id directory. For the page you want to translate, copy from original content/en and translate. Make sure the directory structure reflects the English one.
6. Push to your fork, then raise Pull-Request from your fork to kubernetes/website. Don't forget to put language/id label. If there's no issue, you will get netlify link to preview your live change.
7. Someone from sig-docs-id will review. If not, go to the Slack channel and remind people.
8. Once sorted, your contribution will be merged and reflected live in Kubernetes ID docs!

Some optional readings to help you, but not required:

• Indonesian readme of kubernetes/website.
• Kubernetes Localization

Some popular Indonesian doc of other technologies that we can refer to:

• VueJS
• Ruby
• ReactJS

Glossary

Writing technical doc in Bahasa Indonesian in itself is a very challenging task, because of our habit in using English terms for technical conversation. This is a learning process for all of us.

To help solving this, we maintain several glossary that can be used for translation in this docs, which will standardize the Indonesian doc ultimately. Keep in mind that glossary list will keep on going as we learn together as Indonesian community. Discuss in #kubernetes-docs-id Slack channel for suggesting new terms. After learning how community writes Indonesian docs, we will attempt to provide standardized writing style guide for Bahasa Indonesia.

RSNI Glossary

This is a RSNI glossary