| Summary: | The documentation search function links to document Chapters that are not in the TOC for the docs. | ||||||
|---|---|---|---|---|---|---|---|
| Product: | Red Hat Satellite 5 | Reporter: | Chuck Mead <csm> | ||||
| Component: | Documentation | Assignee: | Russell Dickenson <rdickens> | ||||
| Status: | CLOSED WONTFIX | QA Contact: | Julie <juwu> | ||||
| Severity: | high | Docs Contact: | |||||
| Priority: | unspecified | ||||||
| Version: | 570 | CC: | dyordano, jdobes, rdickens, tlestach | ||||
| Target Milestone: | --- | ||||||
| Target Release: | --- | ||||||
| Hardware: | Unspecified | ||||||
| OS: | Linux | ||||||
| Whiteboard: | |||||||
| Fixed In Version: | Doc Type: | Bug Fix | |||||
| Doc Text: | Story Points: | --- | |||||
| Clone Of: | Environment: | ||||||
| Last Closed: | 2017-07-27 23:48:05 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: | |||||
| Attachments: |
|
||||||
|
Description
Chuck Mead
2016-02-04 14:56:27 UTC
After further review it's certain that this is not a single problem. There is a systemic issue with the in-system documentation. It's producing Internal Server Errors on search functions as well. -------------------------------------- Attention: Jan Dobes and Tomas Lestach -------------------------------------- This BZ ticket was raised against Satellite 5.7, and initially stated that the table of contents of the Client Configuration Guide, as shown within the web UI, was incorrect. Specifically, if you searched the in-product documentation for the term "kickstart", a chapter 7 in the Client Configuration Guide was returned. I first logged in to a Satellite 5.8.0 (Beta) installation and browsed the in-product documentation. I compared the Client Configuration Guide's TOC within the product against that in the Customer Portal, and with the exception of 1 section, they were the same. However, the chapter count stopped at 5. This led to the question, then, of "Where is this mysterious chapter 7?" In fact there is not a chapter 7, titled "Implementing Kickstart". A quick Internet revealed that there is such a chapter in the RHN 5.0.0 Client Configuration Guide. Also strange is that if you search the in-product documentation for "kickstart" and open "Chapter 7. Implementing Kickstart", then navigate to the document's revision history, it has a published year of "2009". This leaves me baffled, and asking: "Why is RHN documentation contained within Red Hat Satellite 5.8.0 (Beta)"? I see the same described behavior. It looks like the old/outdated pages from the Client Confiuguration Guide haven't been removed for Sat 5.6/5.7. I see the first occurrence of the guides/client-config/en-US/ch-rhnreg-ks.jsp page in Mar 2009. However Sat 5.8 is no longer affected. ------------------------ Attention: Tomas Lestach ------------------------ Thank you for your reply in comment 3. The Satellite 5.8 (Beta) build I had checked did not contain the Satellite 5.8 documentation, so I'm glad to have it confirmed that Satellite 5.8 is no longer affected. This leads to the question, though: How can we rectify this problem for Satellite 5.6 and Satellite 5.7? I expect a refresh of the documentation, in the respective product repositories, would solve the problem. But is this likely, given the support status of these versions? |