Bug 2071747 - Link to documentation from the overview page goes to a missing link
Summary: Link to documentation from the overview page goes to a missing link
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Management Console
Version: 4.10
Hardware: s390x
OS: Linux
medium
low
Target Milestone: ---
: 4.11.0
Assignee: Jakub Hadvig
QA Contact: Yanping Zhang
Latha S
URL:
Whiteboard:
: 2105022 (view as bug list)
Depends On:
Blocks: 2080389
TreeView+ depends on / blocked
 
Reported: 2022-04-04 17:21 UTC by Christian LaPolt
Modified: 2023-09-15 01:53 UTC (History)
10 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2022-08-10 11:03:18 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)
Console Overview screenshot (133.63 KB, image/png)
2022-04-28 15:11 UTC, Silke Niemann
no flags Details


Links
System ID Private Priority Status Summary Last Updated
Github openshift console pull 11417 0 None open Bug 2071747: Fix the machine configuration docs link 2022-04-28 15:25:27 UTC
Github openshift console pull 11668 0 None open Bug 2071747: Fix the machine configuration docs link 2022-06-08 08:13:58 UTC
Red Hat Product Errata RHSA-2022:5069 0 None None None 2022-08-10 11:03:46 UTC

Description Christian LaPolt 2022-04-04 17:21:30 UTC
Document URL: 
https://access.redhat.com/documentation/en-us/openshift_container_platform/4.10/post_installation_configuration/machine-configuration-tasks.html
Section Number and Name: 
N/A

Describe the issue: 
VIA the UI console under the Home/Overview section, the Getting Started Resources link to "View all steps in documentation" link goes to a 404 Error :
    d8888   .d8888b.      d8888
   d8P888  d88P  Y88b    d8P888
  d8P 888  888    888   d8P 888
 d8P  888  888    888  d8P  888
d88   888  888    888 d88   888
8888888888 888    888 8888888888
      888  Y88b  d88P       888
      888   "Y8888P"        888


Not Found

The page you are looking for is not here. It might have been moved, removed, or had its name and address changed. It might otherwise be temporarily unavailable for technical reasons.

The good news is that you can probably find what you are looking for by searching the site.

Suggestions for improvement: While this does provide a link to https://access.redhat.com/search/#/. I don't think it should come up as a 404 error, perhaps have the original link go to the doc search page.

Additional information:

Comment 3 Silke Niemann 2022-04-28 15:11:48 UTC
Created attachment 1875706 [details]
Console Overview screenshot

To better visualize it's the "View all steps in documentation" link that leads to the 404.

Comment 5 Salvatore Colangelo 2022-04-29 23:09:33 UTC
[scolange@scolange ~]$ oc get clusterversion
NAME      VERSION                              AVAILABLE   PROGRESSING   SINCE   STATUS
version   4.11.0-0.nightly-2022-04-26-181148   True        False         8h      Cluster version is 4.11.0-0.nightly-2022-04-26-181148


Problem still there :

https://access.redhat.com/documentation/en-us/openshift_container_platform/4.11/post_installation_configuration/machine-configuration-tasks.html


   d8888   .d8888b.      d8888
   d8P888  d88P  Y88b    d8P888
  d8P 888  888    888   d8P 888
 d8P  888  888    888  d8P  888
d88   888  888    888 d88   888
8888888888 888    888 8888888888
      888  Y88b  d88P       888
      888   "Y8888P"        888


Not Found

The page you are looking for is not here. It might have been moved, removed, or had its name and address changed. It might otherwise be temporarily unavailable for technical reasons.

The good news is that you can probably find what you are looking for by searching the site.

Comment 8 Jakub Hadvig 2022-05-09 11:01:45 UTC
The issue with the url is that the 4.11 docs are not available yet.
If you check the 4.10 link its working:
https://access.redhat.com/documentation/en-us/openshift_container_platform/4.10/html/post-installation_configuration/post-install-machine-configuration-tasks

The docs are being released after the feature freeze, thats why they are not available.

Comment 10 Yanping Zhang 2022-05-11 07:50:44 UTC
@Jakub, check on 4.11 cluster, the doc link is "https://access.redhat.com/documentation/en-us/openshift_container_platform/4.11/post-installation_configuration/post-install-machine-configuration-tasks.html", which lacks "html" after "4.11". Will it add "html" automatically after 4.11 release?

Comment 12 Christian LaPolt 2022-06-22 20:36:07 UTC
Hi All, Has there been update to the question in comment 10?  Additionally, this issue is also seen in 4.10.18 I have noticed.

Comment 14 Yanping Zhang 2022-06-24 03:53:00 UTC
Checked on ocp 4.11 cluster with payload 4.11.0-0.nightly-2022-06-23-092832.
Go to Home->Overview page, check link for "View all steps in documentation", it's "https://access.redhat.com/documentation/en-us/openshift_container_platform/4.11/html/post-installation_configuration/post-install-machine-configuration-tasks" now, the url is correct.
The bug is fixed.

Comment 16 Yadan Pei 2022-06-29 10:14:45 UTC
reopen this bug since the `View all steps in documentation` should better link to Post-installation chapter https://access.redhat.com/documentation/en-us/openshift_container_platform/4.10/html/post-installation_configuration/index or Post-installation overview https://access.redhat.com/documentation/en-us/openshift_container_platform/4.10/html/post-installation_configuration/post-install-configuration-overview

opayne could you help confirm?

Comment 17 Olivia Payne 2022-06-30 12:10:25 UTC
@yapei Does "View all steps in documentation" mean all steps for post-installation configuration or post-installation machine configuration tasks?

If it is "all steps" for post-installation configuration, I agree the link to the book https://access.redhat.com/documentation/en-us/openshift_container_platform/4.10/html/post-installation_configuration/index would be good and users can go to the specific chapter they need. 

If if is "all steps" for post-installation machine configuration tasks I think https://access.redhat.com/documentation/en-us/openshift_container_platform/4.10/html/post-installation_configuration/post-install-machine-configuration-tasks might be best. 


I am thinking, since this is a "getting started" resource link, that linking to the post-installation configuration book is the best solution.

Comment 18 Yadan Pei 2022-07-01 01:42:13 UTC
Yeah, I agree linking to post-installation configuration book https://access.redhat.com/documentation/en-us/openshift_container_platform/4.10/html/post-installation_configuration/index would be the best since it is general getting started guide about `Finish setting up your cluster with recommended configurations.` it is not specific to machine configuration tasks

Comment 19 Jakub Hadvig 2022-07-07 14:41:02 UTC
Closed due to conversation with opayne that we should official should be `html/post-installation_configuration/post-install-machine-configuration-tasks`

Comment 20 Jakub Hadvig 2022-07-08 13:56:51 UTC
*** Bug 2105022 has been marked as a duplicate of this bug. ***

Comment 21 Yanping Zhang 2022-07-13 11:12:29 UTC
@jhadvig  to verify this bug, if we need wait for pr https://github.com/openshift/console/pull/11768/files to merge?

Comment 22 Yanping Zhang 2022-07-19 08:18:49 UTC
Checked on ocp 4.12 cluster with payload 4.12.0-0.nightly-2022-07-17-215842.
On Overview page, the "View all steps in documentation" link points to: https://access.redhat.com/documentation/en-us/openshift_container_platform/4.11/html/post-installation_configuration/index . It's consistent with the fix in pr11768.

Comment 23 errata-xmlrpc 2022-08-10 11:03:18 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 (Important: OpenShift Container Platform 4.11.0 bug fix and security 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/RHSA-2022:5069

Comment 24 Red Hat Bugzilla 2023-09-15 01:53:37 UTC
The needinfo request[s] on this closed bug have been removed as they have been unresolved for 365 days


Note You need to log in before you can comment on or make changes to this bug.