I18n/zh cn 20231202

README.md

@@ -27,6 +27,27 @@ All the Markdown files **MUST** be edited in english. To work locally in english
 
 - Open a PR with your changes.
 
+##### Work locally (translations)
+
+To work with translations, those are the steps to update the translated content:
+
+- Run a local server for the language you want to edit: `./translations.sh zh-cn` for instance. If no language is provided, the script will only extract translations from english.
+
+- Open the translation file you are interested in `po/zh-cn.po` for instance. You can also use editors like [poedit](https://poedit.net/) to help you on this task.
+
+- When you are done, you should only have changes into the `po/xx.po` file. Commit them and open a PR.
+  The PR must stars with `i18n` to let the maintainers know that the PR is only changing translation.
+
+The translation work is inspired from [Comprehensive Rust repository](https://github.com/google/comprehensive-rust/blob/main/TRANSLATIONS.md).
+
+##### Initiate a new translation for your language
+
+If you wish to initiate a new translation for your language without running a local server, consider the following tips:
+
+- Execute the command `./translations.sh new xx` (replace `xx` with your language code). This method can generate the `xx.po` file of your language for you.
+- To update your `xx.po` file, execute the command `./translations.sh xx` (replace `xx` with your language code), as mentioned in the previous chapter.
+- If the `xx.po` file already exists (which means you are not initiating a new translation), you should not run this command.
+
 #### Cairo programs
 
 The current book has script that verifies the compilation of all Cairo programs in the book.