diff --git a/docs/Common-issues.md b/docs/Common-issues.md
deleted file mode 100644
index ae05fe326a..0000000000
--- a/docs/Common-issues.md
+++ /dev/null
@@ -1,14 +0,0 @@
-## Python Issues OSX
-
-Make sure you are using the native Python version in OSX.  If you use a MacPorts of HomeBrew version, you may run into problems.
-
-If you have issues with `execvp`, be sure to check your `$PYTHON` environment variable.  If it is not set to the native version, unset it and try again.
-
-Notes: https://gist.github.com/erichocean/5177582
-
-## npm ERR! `node-gyp rebuild`(Windows)
-* just install the build tools from [here](https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=BuildTools)
-Please note the version as is required in below command e.g **2017**
-* Launch cmd, run `npm config set msvs_version 2017`
-* close and open new CMD/terminal and all is well :100: 
-
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 0000000000..1bec1f0d57
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,11 @@
+## Versions of `node-gyp` that are earlier than v8.x.x
+
+Please look thru your error log for the string `gyp info using node-gyp@` and if that version number is less than the [current release of node-gyp](https://github.com/nodejs/node-gyp/releases) then __please upgrade__ using [these instructions](https://github.com/nodejs/node-gyp/blob/master/docs/Updating-npm-bundled-node-gyp.md) and then try your command again.
+
+## `node-sass` is deprecated
+
+Please be aware that the package [`node-sass` is deprecated](https://github.com/sass/node-sass#node-sass) so you should actively seek alternatives.  Please avoid opening new `node-sass` issues on this repo.  You can try `npm install --global node-sass@latest` but we [cannot help much](https://github.com/nodejs/node-gyp/issues?q=is%3Aissue+label%3A%22Node+Sass+--%3E+Dart+Sass%22+) here.
+
+## Issues finding the installed Visual Studio
+
+In cmd, [`npm config set msvs_version 20xx`](https://github.com/nodejs/node-gyp#on-windows) with ___xx___ matching your locally installed version of Visual Studio.