Bug 1789984

Summary: No link to system documentation
Product: Red Hat Enterprise Linux 8 Reporter: Andreas Nilsson <anilsson>
Component: redhat-releaseAssignee: Djordje Todorovic <dtodorov>
Status: CLOSED ERRATA QA Contact: Release Test Team <release-test-team>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 8.3CC: dtodorov, lisas, mmarusak, mpitt, pkotvan, pzatko, release-test-team, toneata
Target Milestone: rcKeywords: TestCaseNeeded, Triaged
Target Release: 8.3   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2021-05-18 13:12:48 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Attachments:
Description Flags
patch to fix the issue none

Description Andreas Nilsson 2020-01-10 22:09:31 UTC 
We're currently working on a new help menu in Cockpit.
https://github.com/cockpit-project/cockpit/pull/13376

The idea behind this menu is to give quick and easy access to system documentation. We want to provide help links for:
1. General OS documentation
2. Cockpit Web Console documentation
3. Specific area documentation, eg. the users page or the services page.

For the General OS documentation, we would like to use the DOCUMENTATION_URL value from /etc/os-release, as specified in the systemd documentation for os-release https://www.freedesktop.org/software/systemd/man/os-release.html#HOME_URL=

Fedora now ships a documentation URL in /etc/os-release that points to https://docs.fedoraproject.org/en-US/fedora/f31/system-administrators-guide/

For RHEL I think the best high-level equivalent would be:
DOCUMENTATION_URL="https://access.redhat.com/documentation/red_hat_enterprise_linux/8/"
as this gives you a good general overview of Red Hat Enterprise Linux.

I'll try to cook up a patch for this early next week.
Comment 1 Andreas Nilsson 2020-01-13 13:29:55 UTC 
Created attachment 1651874 [details]
patch to fix the issue
Comment 2 Martin Pitt 2020-01-13 13:35:50 UTC 
Thanks Andreas! I confirm that %{base_release_version} expands to exactly "8" and https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/ works.
Comment 3 Lisa S 2020-04-06 05:49:07 UTC 
https://projects.engineering.redhat.com/browse/RCM-79726
Comment 4 Peter Kotvan 2020-05-15 07:57:27 UTC 
Providing qa_ack+. We can extend our redhat-release test to include this as well.
Comment 8 Lisa S 2020-10-06 21:17:00 UTC 
Peter, can you qa_ack this for 8.4?
Comment 9 Matej Marušák 2020-10-30 06:05:03 UTC 
Today checked out 8.4 compose and this is already present.
Thank you!
Comment 20 errata-xmlrpc 2021-05-18 13:12:48 UTC 
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory (redhat-release bug fix and enhancement update), and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHBA-2021:1569