diff --git a/README.md b/README.md
index c4d5727..8cd668c 100644
--- a/README.md
+++ b/README.md
@@ -18,29 +18,19 @@ Key files for localization are:
 ### Locale commands
 
 To update translation key values:
-
-`npm run write-translations -- --locale <locale>`
-
-By default, write-translate only appends new values. To also update existing values:
-- Note this will overwrite **all** JSON stored translations to English.
-
-`docusaurus write-translations --locale <locale> --overrride`
+npm run write-translations -- --locale <locale>
 
 To updated po4a consolidated .pot and .po files from English markdown files (with po4a tool installed):
-
-`po4a po4a.conf --no-translations`
+po4a po4a.conf --no-translations
 
 To update localization markdown files from po4a consolidated .po files (with po4a tool installed):
-
-`po4a po4a.conf --no-update`
+po4a po4a.conf --no-update
 
 To run the site in a specific locale:
-
-`npm run start -- --locale <locale>`
+npm run start -- --locale <locale>
 
 To build the static site for all locales:
-
-`npm run build`
+npm run build
 
 ### Localization mapping
 
diff --git a/README2.md b/README2.md
new file mode 100644
index 0000000..b28211a
--- /dev/null
+++ b/README2.md
@@ -0,0 +1,41 @@
+# Website
+
+This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+
+## Installation
+
+```bash
+yarn
+```
+
+## Local Development
+
+```bash
+yarn start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+## Build
+
+```bash
+yarn build
+```
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
+
+## Deployment
+
+Using SSH:
+
+```bash
+USE_SSH=true yarn deploy
+```
+
+Not using SSH:
+
+```bash
+GIT_USER=<Your GitHub username> yarn deploy
+```
+
+If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.