Bug 1469566 - Broken link to remote API docs
Summary: Broken link to remote API docs
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: JBoss Operations Network
Classification: JBoss
Component: Documentation
Version: JON 3.0.0
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: post-GA
: ---
Assignee: Tyler Kelly
QA Contact: Mike Foley
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2017-07-11 13:53 UTC by Larry O'Leary
Modified: 2017-08-25 05:12 UTC (History)
3 users (show)

Fixed In Version:
Clone Of:
Environment:
Last Closed: 2017-08-25 05:12:07 UTC
Type: Bug
Embargoed:


Attachments (Terms of Use)

Description Larry O'Leary 2017-07-11 13:53:52 UTC
Document URL: 

https://access.redhat.com/documentation/en-US/Red_Hat_JBoss_Operations_Network/3.0/html/Running_JON_Command-Line_Scripts/about-cli.html#java-reading

Section Number and Name: 
2.2. MORE JAVA RESOURCES

Describe the issue: 
The link http://docs.redhat.com/docs/en-US/JBoss_Operations_Network/3.0/html/API_Guides/index.html results in a 404.

Suggestions for improvement:
I am not sure where this document actually lives. Additionally, this URL seems to be referenced in other places as well. For example, I see it in the second paragraph of section 2. USING THE JBOSS ON CLI TO SCRIPT TASKS

The document that it should reference should be the JBoss ON 3.0 API Guide... I am not certain if this should be the actual Remote API JavaDoc or if this should be a guide that contained the JavaDoc link for the Remote API JavaDoc and Domain API JavaDoc.

Comment 2 Tyler Kelly 2017-07-12 02:08:48 UTC
This link refers to the doc when it was published under JON not RHJON, it's possible that the writers at the time had to change the title and url to not conflict with the older names.

The versions I have ready for publish also have these broken links. I will try to fix them up before I publish.

Comment 3 Tyler Kelly 2017-07-12 08:00:15 UTC
So far, I have fixed all the internal links in the 3.0 docs except for the API doc you have mentioned (there are about 13 of them throughout the docs). 

The API doc was published, and we still publish current versions of the API.
After re-checking the svn repo (https://svn.devel.redhat.com/repos/ecs/JON/) where the docs were previously and in brew (https://brewweb.engineering.redhat.com/brew/buildinfo?buildID=300351) I still can't find a copy.

However, the 3.1 API doc has been recovered and lists changes from 2.4 to 3.0, 3.0 to 3.01 and 3.01 to 3.1.

https://brewweb.engineering.redhat.com/brew/packageinfo?packageID=44277

I could try re-add this API doc to 3.1 docs and change these links to point to it?

Comment 4 Larry O'Leary 2017-07-13 13:17:55 UTC
That will work Tyler.

Comment 5 Tyler Kelly 2017-07-14 01:19:22 UTC
Git Commits:
https://gitlab.cee.redhat.com/tkelly/jon_pre33/commit/09a3cf94dba5e35077d33bab5a8a78331f0132a7
https://gitlab.cee.redhat.com/tkelly/jon_pre33/commit/41b649c27791df4d868ca91f3d7a51252f2a9d2a

Git Merge:
https://gitlab.cee.redhat.com/red-hat-jboss-operations-network-documentation/jon_pre33/merge_requests/57

Pantheon Preview:
All 3.0 docs - search for "https://access.redhat.com/documentation/en-US" to find all 40+ changes, links can be provided if required.

Recommend QA review commits (above) rather than previews due to the volume of small changes.

Comment 10 Tyler Kelly 2017-08-25 05:12:07 UTC
Updated content now live on the customer portal:
Change regarding comment 6:
https://access.redhat.com/documentation/en-us/red_hat_jboss_operations_network/3.0/html-single/running_jon_command-line_scripts/#java-reading
Other changes are spread across the version 3.0 documentation, found here:
https://access.redhat.com/documentation/en/red-hat-jboss-operations-network/?version=3.0


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