Description of problem: Datasource description in installer points to old documentation Version-Release number of selected component (if applicable): EAP 6.4.0.DR4 How reproducible: always Steps to Reproduce: 1. run EAP installer 2. on the Configure runtime environment screen select to Install JDBC driver 3. click the link "If your driver is not supported, click here" Actual results: https://access.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html/Administration_and_Configuration_Guide/sect-Datasource_Configuration.html Expected results: Link to EAP 6.4 documentation Additional info: Please consult the new location with documentation team, it may not be https://access.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.4/html/Administration_and_Configuration_Guide/sect-Datasource_Configuration.html
I think for this issue, it's better to change our link to https://access.redhat.com/documentation/en-US/JBoss_Enterprise_Application_Platform/ instead of the link we're currently using. Does this sound good Nikoleta?
Nikoleta is right. The 'JBoss Enterprise Application Platform' guides are being renamed to 'Red Hat JBoss Enterprise Application Platform' for 6.4. I believed the URL in comment 2 is correct. Thomas, if you have room, you can use the basic URL, but specify the book and section, for example: If your driver is not supported, see the 'Datasource Configuration' section of the `Administration and Configuration Guide' for Red Hat JBoss Enterprise Application Platform [located here: https://access.redhat.com/documentation/en-US/Red_Hat_JBoss_Enterprise_Application_Platform/]. If you don't have the space, you could turn the 'Administration and Configuration Guide' into a link. Tom or Russell, do you know if the above links are correct or do you have a better suggestion?
I've changed the link to be https://access.redhat.com/documentation/en-US/Red_Hat_JBoss_Enterprise_Application_Platform/ . Note that this does not work yet since the Documentation is not staged.
Hey Tom I believe this could be moved to ON_QA.
I don't think we should point the link from 'Admininstration and Configuration Guide' to https://access.redhat.com/site/documentation/en-US/Red_Hat_JBoss_Enterprise_Application_Platform/ since it points to documentation index page not to A&C guide itself (the screen similar to https://access.redhat.com/documentation/en-US/JBoss_Enterprise_Application_Platform/). --------------------------------- ... You can find examples for major databases in the 'Datasource Configuration' section of the EAP documentation, which can serve as a template for your definition. EAP Documentation - [Admininstration and Configuration Guide|https://access.redhat.com/site/documentation/en-US/Red_Hat_JBoss_Enterprise_Application_Platform/] --------------------------------- how about --------------------------------- ... You can find examples for major databases in the 'Datasource Configuration' section of the Administration and Configuration Guide, which can serve as a template for your definition. [EAP Documentation|https://access.redhat.com/site/documentation/en-US/Red_Hat_JBoss_Enterprise_Application_Platform/] ---------------------------------
Agreed Petr, will update the link for DR13.
Also I was told that we shouldn't be linking to chapters directly, but to the index page. Do you have any comments, Sande?
Thomas, that is my understanding. We point them to the chapter or section. Tom Wells, can you verify the above and also what the link for the JBoss EAP 6.4 documentation will be?
I've updated the string with another interim message until we get some feedback :)
Verified on EAP 6.4.0.DR13. Hey Tom, I was just using jira syntax for making links, I wasn't trying to force you to use "|" as separator :), but I guess we can stay like this.
The needinfo request[s] on this closed bug have been removed as they have been unresolved for 1000 days