Merge pull request #1358 from EnterpriseDB/release/2021-05-11

Former-commit-id: dba19b2

README.md

@@ -28,13 +28,13 @@ We recommend using MacOS to work with the EDB Docs application.
 
 1. Install Python 3 with `brew install python3`, if it's not already installed. (Use `python3 -V` to check that you have version 3.6 or higher.) Python is not needed for the core Gatsby system, but is required by several source scripts.
 
-1. Install Yarn with `npm i -g yarn`. Yarn is the package manager we're using for this project, instead of NPM.
+1. Install Yarn with `npm i -g yarn`. Yarn is the package manager we're using for this project, instead of NPM. NPM may fail with a permissions related issue. To fix that, ensure that your user account owns the required directory: `sudo chown -R $(whoami) /usr/local/lib/node_modules`
 
 1. Install Gatsby with `npm i -g gatsby-cli`. Gatsby is the software that powers the EDB Docs site.
 
 1. Install all required packages by running `yarn`.
 
-1. Pull the shared icon files down with `git submodule update --init`.
+1. Pull the shared icon files down with `git submodule update --init`. This needs to be run inside of the project folder, if you have cloned the repo using GitHub Desktop, ensure that you have `cd` into the project.
 
 1. And finally, you can start up the site locally with `yarn develop`, which should make it live at `http://localhost:8000/`. Huzzah!
 

README_DOCKER_VSCODE.md

@@ -7,14 +7,15 @@ If you cannot or do not wish to install the prerequisite versions of Python, Nod
 1. [Docker](https://docs.docker.com/get-docker/) (for MacOS or Windows, that'll be Docker Desktop)
 2. [Visual Studio Code](https://code.visualstudio.com/docs/setup/setup-overview)
 3. The [Remote Development Extension Pack](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack) for VSCode
+4. [Git](https://git-scm.com/download)
 
 If you intend to edit using VSCode, I also recommend installing the [MDX extension](https://marketplace.visualstudio.com/items?itemName=silvenon.mdx) - this is not required, but it is handy!
 
 ## Installation
 
 1. In VSCode, from the command pallet select the `Remote-Containers: Clone Repository in Container Volume...` command
 2. Paste in the URL of this repository, or a GitHub branch URL, or a GitHub PR URL 
-3. Choose "isolated volume" (in most cases this will be what you want) 
+3. Choose "unique volume" (in most cases this will be what you want) 
 4. Wait for VSCode to build the container, then open a terminal
 8. Run the site locally with `yarn develop`. VSCode will remap port 8000 used within the container to a free port on your machine, which you can view from the Remote Explorer panel in the left sidebar - or ctrl+click the URL that Gatsby prints in the terminal to open directly.