diff --git a/BUILDING.md b/BUILDING.md
index b325972f4b66d9..92a64286db113b 100644
--- a/BUILDING.md
+++ b/BUILDING.md
@@ -72,6 +72,11 @@ Depending on host platform, the selection of toolchains may vary.
 * Building native add-ons: Visual Studio 2013 or Visual C++ Build Tools 2015
   or newer
 
+### Shared libraries & dependencies
+
+Node.js intends to support building against shared representations of
+dependencies found in the [*deps*](./deps/) directory.
+
 ## Building Node.js on supported platforms
 
 ### Unix / OS X
diff --git a/README.md b/README.md
index 5957e5e526c4cd..73b854fb24ad1f 100644
--- a/README.md
+++ b/README.md
@@ -132,7 +132,7 @@ the binary verification command above.
 ## Building Node.js
 
 See [BUILDING.md](BUILDING.md) for instructions on how to build
-Node.js from source.
+Node.js from source along with a list of officially supported platforms.
 
 ## Security