4 files changed, 44 insertions, 2 deletions

diff --git a/support/doc/api/openapi.yaml b/support/doc/api/openapi.yaml
index c23df46a6..7b67b5c64 100644
--- a/support/doc/api/openapi.yaml
+++ b/support/doc/api/openapi.yaml
@@ -1,7 +1,7 @@
 openapi: 3.0.0
 info:
   title: PeerTube
-  version: 1.2.1
+  version: 1.3.0-rc.1
   contact:
     name: PeerTube Community
     url: 'https://joinpeertube.org'
diff --git a/support/doc/development/localization.md b/support/doc/development/localization.md
index 97e9e2c51..1664532fe 100644
--- a/support/doc/development/localization.md
+++ b/support/doc/development/localization.md
@@ -31,3 +31,10 @@ Then, `iso639` files will be merged in `server` files (so we have only one JSON
 ```
 $ zanata-cli pull
 ```
+
+## Support a new language
+
+ * Add it to [/shared/models/i18n/i18n.ts](/shared/models/i18n/i18n.ts)
+ * Add it to [/scripts/build/client.sh](/scripts/build/client.sh)
+ * Pull using zanata (that will execute hooks to correctly generate files of this new language)
+ * Build the application and check the new language correctly works
diff --git a/support/doc/development/release.md b/support/doc/development/release.md
new file mode 100644
index 000000000..352a1f0d3
--- /dev/null
+++ b/support/doc/development/release.md
@@ -0,0 +1,20 @@
+# Release
+
+ * Fix remaining important bugs
+ * Update [/CHANGELOG.md](/CHANGELOG.md)
+ * Check migrations:
+    * `npm run clean:server:test`
+    * `git checkout master && rm -r ./node_modules && yarn install --pure-lockfile && npm run build:server`
+    * `NODE_APP_INSTANCE=6 NODE_ENV=test npm run start` and quit after initialization
+    * `git checkout develop && rm -r ./node_modules && yarn install --pure-lockfile && npm run build:server`
+    * `NODE_APP_INSTANCE=6 NODE_ENV=test npm run start` and check migrations does not fail
+ * Run `rm -r node_modules && rm -r client/node_modules && yarn install --pure-lockfile && npm run build` to see if all the supported languages compile correctly
+ * Update https://peertube2.cpy.re and check it works correctly
+ * Check Travis tests are green
+ * Run E2E tests: `BROWSERSTACK_USER=my_user BROWSERSTACK_KEY=my_key npm run e2e`
+ * Release: `GITHUB_TOKEN=my_token npm run release -- 1.x.x`
+ * Create a dedicated branch: `git checkout -b release/1.x.x && git push origin release/1.x.x`
+ * Check the release is okay: https://github.com/Chocobozzz/PeerTube/releases
+ * Update https://peertube3.cpy.re and check it works correctly
+ * Update all other instances and check it works correctly
+ * Communicate on Mastodon & peertube-admin mailing list
diff --git a/support/doc/translation.md b/support/doc/translation.md
index 5267c3899..58b52f5f8 100644
--- a/support/doc/translation.md
+++ b/support/doc/translation.md
@@ -26,10 +26,25 @@ There are 4 files:
 
 ## Tips
 
+### Special tags
+
 You must not translate special tags like `<x id="INTERPOLATION" ... />`.
 
 For example: 
 ```<x id="INTERPOLATION" equiv-text="{{ video.publishedAt | myFromNow }}"/> - <x id="INTERPOLATION_1" equiv-text="{{ video.views | myNumberFormatter }}"/> views```
 
 should be in french 
-```<x id="INTERPOLATION" equiv-text="{{ video.publishedAt | myFromNow }}"/> - <x id="INTERPOLATION_1" equiv-text="{{ video.views | myNumberFormatter }}"/> vues```
\ No newline at end of file
+```<x id="INTERPOLATION" equiv-text="{{ video.publishedAt | myFromNow }}"/> - <x id="INTERPOLATION_1" equiv-text="{{ video.views | myNumberFormatter }}"/> vues```
+
+
+### Singular/plural
+
+For singular/plural translations, you must translate values inside `{` and `}`.
+
+For example:
+
+```{VAR_PLURAL, plural, =0 {No videos} =1 {1 video} other {<x id="INTERPOLATION" equiv-text="{{ playlist.videosLength }}"/> videos} }```
+
+should be in french 
+
+```{VAR_PLURAL, plural, =0 {Aucune vidéos} =1 {1 vidéo} other {<x id="INTERPOLATION" equiv-text="{{ playlist.videosLength }}"/> vidéos} }```