2 files changed, 27 insertions, 0 deletions

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