diff --git a/Library/Homebrew/os/mac.rb b/Library/Homebrew/os/mac.rb
index 12091d20b1..0f2b8ae060 100644
--- a/Library/Homebrew/os/mac.rb
+++ b/Library/Homebrew/os/mac.rb
@@ -35,12 +35,14 @@ module OS
     end
 
     def latest_stable_version
-      # TODO: bump version when new macOS is released
+      # TODO: bump version when new macOS is released and also update
+      # references in docs/Installation.md
       Version.new "10.13"
     end
 
     def outdated_release?
-      # TODO: bump version when new macOS is released
+      # TODO: bump version when new macOS is released and also update
+      # references in docs/Installation.md
       version < "10.11"
     end