diff --git a/docs/guides/main.rst b/docs/guides/main.rst
index c0f85f1af..ee9e59df1 100644
--- a/docs/guides/main.rst
+++ b/docs/guides/main.rst
@@ -14,7 +14,7 @@ dropped, and Python 3.x is not yet supported.)
 
 .. _Python 2.7: http://www.python.org/download/
 
-* **Mac OS X** v10.7 (Lion) and later include Python 2.7 out of the box.
+* **macOS** v10.7 (Lion) and later include Python 2.7 out of the box.
 
 * On **Debian or Ubuntu**, depending on the version, beets is available as an
   official package (`Debian details`_, `Ubuntu details`_), so try typing:
@@ -69,10 +69,10 @@ new versions.
 
 .. _@b33ts: http://twitter.com/b33ts
 
-Installing on Mac OS X 10.11 and higher
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Installing on macOS 10.11 and Higher
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Starting with Mac OS X 10.11 (El Capitan), Apple has enabled `System Integrity Protection`_ (SIP), and because of SIP, some installation processes may fail, even with ``sudo``, because they intrude on protected areas of the system (if you've installed python via `Homebrew`_ this probably won't happen since the Python libraries are installed to an unrestricted folder). If this does happen, try installing beets only for the current user by running ``pip install --user beets``. It might also be a good idea to add ``~/Library/Python/2.7/bin`` to your ``$PATH``.
+Starting with macOS 10.11 (El Capitan), Apple has enabled `System Integrity Protection`_ (SIP), and because of SIP, some installation processes may fail, even with ``sudo``, because they intrude on protected areas of the system (if you've installed python via `Homebrew`_ this probably won't happen since the Python libraries are installed to an unrestricted folder). If this does happen, try installing beets only for the current user by running ``pip install --user beets``. It might also be a good idea to add ``~/Library/Python/2.7/bin`` to your ``$PATH``.
 
 .. _System Integrity Protection: https://support.apple.com/en-us/HT204899
 .. _Homebrew: http://brew.sh