From ac9a96874e57d3beedbbe3be7dce889d8a16530e Mon Sep 17 00:00:00 2001
From: Troy McCabe <troymccabe@gmail.com>
Date: Sun, 11 Sep 2022 22:10:37 -0500
Subject: [PATCH 1/3] Adds `brew docs` to close #13834

---
 Library/Homebrew/cmd/docs.rb           | 24 ++++++++++++++++++++++++
 Library/Homebrew/global.rb             |  1 +
 Library/Homebrew/test/cmd/docs_spec.rb | 11 +++++++++++
 3 files changed, 36 insertions(+)
 create mode 100644 Library/Homebrew/cmd/docs.rb
 create mode 100644 Library/Homebrew/test/cmd/docs_spec.rb

diff --git a/Library/Homebrew/cmd/docs.rb b/Library/Homebrew/cmd/docs.rb
new file mode 100644
index 0000000000..14eecc05ac
--- /dev/null
+++ b/Library/Homebrew/cmd/docs.rb
@@ -0,0 +1,24 @@
+# typed: true
+# frozen_string_literal: true
+
+require "cli/parser"
+
+module Homebrew
+  extend T::Sig
+
+  module_function
+
+  sig { returns(CLI::Parser) }
+  def docs_args
+    Homebrew::CLI::Parser.new do
+      description <<~EOS
+        Open Homebrew's docs (https://docs.brew.sh) in a browser.
+      EOS
+    end
+  end
+
+  sig { void }
+  def docs
+    exec_browser HOMEBREW_DOCS_WWW
+  end
+end
diff --git a/Library/Homebrew/global.rb b/Library/Homebrew/global.rb
index 1a11464f69..0f404ac482 100644
--- a/Library/Homebrew/global.rb
+++ b/Library/Homebrew/global.rb
@@ -45,6 +45,7 @@ HOMEBREW_REQUIRED_RUBY_VERSION = ENV.fetch("HOMEBREW_REQUIRED_RUBY_VERSION").fre
 HOMEBREW_PRODUCT = ENV.fetch("HOMEBREW_PRODUCT").freeze
 HOMEBREW_VERSION = ENV.fetch("HOMEBREW_VERSION").freeze
 HOMEBREW_WWW = "https://brew.sh"
+HOMEBREW_DOCS_WWW = "https://docs.brew.sh"
 HOMEBREW_SYSTEM = ENV.fetch("HOMEBREW_SYSTEM").freeze
 HOMEBREW_PROCESSOR = ENV.fetch("HOMEBREW_PROCESSOR").freeze
 
diff --git a/Library/Homebrew/test/cmd/docs_spec.rb b/Library/Homebrew/test/cmd/docs_spec.rb
new file mode 100644
index 0000000000..eade3c152b
--- /dev/null
+++ b/Library/Homebrew/test/cmd/docs_spec.rb
@@ -0,0 +1,11 @@
+# typed: false
+# frozen_string_literal: true
+
+describe "brew docs" do
+  it "opens the docs page", :integration_test do
+    expect { brew "docs", "HOMEBREW_BROWSER" => "echo" }
+      .to output("https://docs.brew.sh\n").to_stdout
+      .and not_to_output.to_stderr
+      .and be_a_success
+  end
+end

From 572a42ccd056ee61cda9e60b3edbf57c9dd8a991 Mon Sep 17 00:00:00 2001
From: Mike McQuaid <mike@mikemcquaid.com>
Date: Mon, 12 Sep 2022 14:12:50 +0100
Subject: [PATCH 2/3] cmd/docs: tweak description.

---
 Library/Homebrew/cmd/docs.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Library/Homebrew/cmd/docs.rb b/Library/Homebrew/cmd/docs.rb
index 14eecc05ac..8492087179 100644
--- a/Library/Homebrew/cmd/docs.rb
+++ b/Library/Homebrew/cmd/docs.rb
@@ -12,7 +12,7 @@ module Homebrew
   def docs_args
     Homebrew::CLI::Parser.new do
       description <<~EOS
-        Open Homebrew's docs (https://docs.brew.sh) in a browser.
+        Open Homebrew's online documentation (https://docs.brew.sh) in a browser.
       EOS
     end
   end

From dbb9af49e7ed20ca23e14ab90710a6c334804bd7 Mon Sep 17 00:00:00 2001
From: Mike McQuaid <mike@mikemcquaid.com>
Date: Mon, 12 Sep 2022 14:25:34 +0100
Subject: [PATCH 3/3] Update Library/Homebrew/cmd/docs.rb

Co-authored-by: Carlo Cabrera <30379873+carlocab@users.noreply.github.com>
---
 Library/Homebrew/cmd/docs.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Library/Homebrew/cmd/docs.rb b/Library/Homebrew/cmd/docs.rb
index 8492087179..31aa410df3 100644
--- a/Library/Homebrew/cmd/docs.rb
+++ b/Library/Homebrew/cmd/docs.rb
@@ -12,7 +12,7 @@ module Homebrew
   def docs_args
     Homebrew::CLI::Parser.new do
       description <<~EOS
-        Open Homebrew's online documentation (https://docs.brew.sh) in a browser.
+        Open Homebrew's online documentation (#{HOMEBREW_DOCS_WWW}) in a browser.
       EOS
     end
   end