Description of problem: Example here: http://www.redhat.com/docs/en-US/JBoss_ON/2.3/html/Feature_Guide/sect-Feature_Guide-Administration-High_Availability.html This doc links out design doc. The design doc is a community maintained page that does not appear to be reviewed by the documents team. The top link is: http://www.redhat.com/docs/en-US/JBoss_ON/2.3/html/Feature_Guide/index.html There are additional places where the design doc is linked, I'll try to find more and paste them into the bug. Thanks
Changing tracker to FoundInRHQ1.3.1
I found six or seven references to the RHQ wiki (for design docs) in the Features Guide, and I've removed them. I just need to get commit perms to http://svn.jboss.org so I can check them in. :) I'll go through the other docs as well.
Bryan brought up a good point in the meeting: what is the purpose of these links? Are they to supply additional content that is not in the guides already, and (if so) should that content be pulled in? My initial take is this. It does look like the doc writer supplied and/or kept those links instead of pulling in the content. I think. However, since a couple of releases of JON are coming up very quickly, I think the best thing to do it focus on pulling that content into JON 3.0 and just leaving the 2.3 docs as they are. (The links basically all reference the high availability design docs, which have changed since 2.3 was released.) Thoughts?
"As they are" meaning, with the links removed but otherwise the same.
I agree, as time goes on the design doc will become more and more irrelevant to JON 231. Pulling the content into JON30 is a good idea. I dont think pulling the content into JON231 is necessary.
Nice. I've gone ahead and spun new docs which should be live on rh.com tomorrow, and I've checked in the changes. The edits *only* remove the links to the design docs.
The link in the description is updated so that the design doc reference is no longer there. I'm changing the status to modified so that QE can verify and close this.
QA Verified.
Mass-closure of verified bugs against JON.