diff --git a/site/_docs/installation.md b/site/_docs/installation.md
index 712e3bae..676bccb4 100644
--- a/site/_docs/installation.md
+++ b/site/_docs/installation.md
@@ -17,7 +17,7 @@ requirements you’ll need to make sure your system has before you start.
 - [Ruby](https://www.ruby-lang.org/en/downloads/) (including development
   headers, v1.9.3 or above for Jekyll 2 and v2 or above for Jekyll 3)
 - [RubyGems](https://rubygems.org/pages/download)
-- Linux, Unix, or Mac OS X
+- Linux, Unix, or macOS
 - [NodeJS](https://nodejs.org/), or another JavaScript runtime (Jekyll 2 and
 earlier, for CoffeeScript support).
 - [Python 2.7](https://www.python.org/downloads/) (for Jekyll 2 and earlier)
@@ -51,8 +51,8 @@ community can improve the experience for everyone.
   <h5>Installing Xcode Command-Line Tools</h5>
   <p>
     If you run into issues installing Jekyll's dependencies which make use of
-    native extensions and are using Mac OS X, you will need to install Xcode
-    and the Command-Line Tools it ships with. Download in
+    native extensions and are using macOS, you will need to install Xcode
+    and the Command-Line Tools it ships with. Download them in
     <code>Preferences &#8594; Downloads &#8594; Components</code>.
   </p>
 </div>
diff --git a/site/_docs/troubleshooting.md b/site/_docs/troubleshooting.md
index 3a2c6170..5a53a9eb 100644
--- a/site/_docs/troubleshooting.md
+++ b/site/_docs/troubleshooting.md
@@ -57,14 +57,14 @@ sudo emerge -av dev-ruby/rubygems
 On Windows, you may need to install [RubyInstaller
 DevKit](https://wiki.github.com/oneclick/rubyinstaller/development-kit).
 
-On Mac OS X, you may need to update RubyGems (using `sudo` only if necessary):
+On macOS, you may need to update RubyGems (using `sudo` only if necessary):
 
 ```sh
 sudo gem update --system
 ```
 
 If you still have issues, you can download and install new Command Line
-Tools (such as `gcc`) using the command
+Tools (such as `gcc`) using the following command:
 
 ```sh
 xcode-select --install
@@ -77,7 +77,7 @@ which may allow you to install native gems using this command (again using
 sudo gem install jekyll
 ```
 
-Note that upgrading Mac OS X does not automatically upgrade Xcode itself
+Note that upgrading macOS does not automatically upgrade Xcode itself
 (that can be done separately via the App Store), and having an out-of-date
 Xcode.app can interfere with the command line tools downloaded above. If
 you run into this issue, upgrade Xcode and install the upgraded Command