diff --git a/docs/api/auto-updater.md b/docs/api/auto-updater.md
index eed46900d1ca..d6437e899be2 100644
--- a/docs/api/auto-updater.md
+++ b/docs/api/auto-updater.md
@@ -2,9 +2,8 @@
 
 **This module has only been implemented for Mac OS X.**
 
-The `auto-updater` module is a simple wrap around the `Squirrel` framework, the
-`Squirrel` framework is not open sourced yet and atom-shell would download the
-binary of `Squirrel` when bootstrapping.
+The `auto-updater` module is a simple wrap around the
+[Squirrel.Mac](https://github.com/Squirrel/Squirrel.Mac) framework.
 
 ## Squirrel
 
diff --git a/docs/development/source-code-directory-structure.md b/docs/development/source-code-directory-structure.md
index 87f1f5eb6d1c..44d15b452a02 100644
--- a/docs/development/source-code-directory-structure.md
+++ b/docs/development/source-code-directory-structure.md
@@ -58,5 +58,5 @@ to understand the source code better.
 * **out** - Temporary output directory of `ninja`.
 * **dist** - Temporary directory created by `script/create-dist.py` script
   when creating an distribution.
-* **frameworks** - Downloaded binaries of third-party frameworks, binaries
-  here are usually either closed source or hard to be built via `gyp`.
+* **frameworks** - Downloaded binaries of third-party frameworks which do not
+  support to be built via `gyp`.