Support branding links to docs.theforeman.org

app/controllers/concerns/documentation_controller_branding.rb

@@ -30,4 +30,13 @@ def plugin_documentation_url
   def wiki_url(section: '')
     documentation_url(section)
   end
+
+  # For new documentation at docs.theforeman.org
+  # We do not use flavor downstream, but keeping it here for the same method signature
+  # rubocop:disable Lint/UnusedMethodArgument
+  def docs_url(guide:, flavor:, chapter: nil)
+    url = ForemanThemeSatellite::Documentation::DOCS_GUIDES_LINKS.dig(guide, chapter)
+    url || "#{ForemanThemeSatellite.documentation_root}/#{guide.downcase}/#{chapter}"
+  end
+  # rubocop:enable Lint/UnusedMethodArgument
 end

lib/foreman_theme_satellite/documentation.rb

@@ -80,5 +80,11 @@ module Documentation
     SPECIAL_LINKS = [
       [/docs\.theforeman\.org\/.*?\/Managing_Hosts\/.*?registering-a-host.*?managing-hosts/i, "#{ForemanThemeSatellite.documentation_root}/managing_hosts/registering_hosts_to_server_managing-hosts#Registering_Hosts_managing-hosts"],
     ]
+
+    DOCS_GUIDES_LINKS = {
+      'Managing_Hosts' => {
+        'registering-a-host_managing-hosts' => "#{ForemanThemeSatellite.documentation_root}/managing_hosts/registering_hosts_to_server_managing-hosts#Registering_Hosts_managing-hosts",
+      }
+    }.freeze
   end
 end

test/functionals/documentation_links_test.rb

@@ -41,4 +41,16 @@ class DocumentationLinksTest < ActiveSupport::TestCase
       refute_equal '404', res.code, "Documentation link #{doc_address} was not found"
     end
   end
+
+  ForemanThemeSatellite::Documentation::DOCS_GUIDES_LINKS.each do |guide, chapters|
+    chapters.each do |key, doc_address|
+      test "#{guide} #{key} entry is valid" do
+        uri = URI(doc_address)
+        res = Net::HTTP.get_response(uri)
+
+        # it can be either 200 or 302
+        refute_equal '404', res.code, "Documentation link #{doc_address} was not found"
+      end
+    end
+  end
 end

test/integration/documentation_controller_branding_test.rb

@@ -0,0 +1,15 @@
+require 'test_plugin_helper'
+
+class DocumentationControllerBrandingTest < ActionDispatch::IntegrationTest
+  def test_docs_redirect_branded
+    get "/links/docs/Managing_Hosts?chapter=registering-a-host_managing-hosts"
+
+    assert_redirected_to "https://access.redhat.com/documentation/en-us/red_hat_satellite/#{ForemanThemeSatellite.documentation_version}/html/managing_hosts/registering_hosts_to_server_managing-hosts#Registering_Hosts_managing-hosts"
+  end
+
+  def test_docs_redirect_unknown_chapter
+    get "/links/docs/Managing_Hosts"
+
+    assert_redirected_to "https://access.redhat.com/documentation/en-us/red_hat_satellite/#{ForemanThemeSatellite.documentation_version}/html/managing_hosts/"
+  end
+end