[jbosstools-issues] [JBoss JIRA] Issue Comment Edited: (TOOLSDOC-253) Fix Getting Started Guide

[Nick Boldt (JIRA)]

    [ https://issues.jboss.org/browse/TOOLSDOC-253?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12630954#comment-12630954 ] 

Nick Boldt edited comment on TOOLSDOC-253 at 9/27/11 11:13 PM:
---------------------------------------------------------------

*Third*:
The extras site for 4.1.1 replaces the site for 4.1 which replaces the site for 4.0. URLs remain unchanged thru the magic of "composite p2 metadata".

Thus for any update to a 4.x release, you use the 4.0/ site, which has at some point contained 4.0.0, 4.0.1, 4.1.0, and soon, 4.1.1.

Note that the page linked above as "third" is a 404'd page: http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Developer_Studio/4.1-/html/Getting_Started_Guide/extras_site.html

*Fouth*:
The Tech Preview site is currently empty since the only thing that was ever on it (BPEL) moved from Tech Preview to Extras for the 4.1.0 release. This allows people to discover it more easily w/o having to manually add the Tech Preview URL, as the Extras site URL is already preloaded in JBDS 4.0.0 onward.

I might argue we could remove the whole chapter and reinstate it, if needed, for a 4.2 release IF AND WHEN there's something to put there. Currently, telling people to look for Tech Previews from a site containing nothing but an empty site.xml may lead to frustration, annoyance, or other less-than-positive vibes about JBoss and our credibility/professionalism.



      was (Author: nickboldt):
    *Third*:
The extras site for 4.1.1 replaces the site for 4.1 which replaces the site for 4.0. URLs remain unchanged thru the magic of "composite p2 metadata".

Thus for any update to a 4.x release, you use the 4.0/ site, which has at some point contained 4.0.0, 4.0.1, 4.1.0, and soon, 4.1.1.

Note that the page linked above as "third" is a 404'd page: http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Developer_Studio/4.1-/html/Getting_Started_Guide/extras_site.html

*Fouth*:

The Tech Preview site is currently empty since the only thing that was ever on it (BPEL) moved from Tech Preview to Extras for the 4.1.0 release. This allows people to discover it more easily w/o having to manually add the Tech Preview URL, as the Extras site URL is already preloaded in JBDS 4.0.0 onward.

I might argue we could remove the whole chapter and reinstate it, if needed, for a 4.2 release IF AND WHEN there's something to put there. Currently, telling people to look for Tech Previews from a site containing nothing but an empty site.xml may lead to frustration, annoyance, or other less-than-positive vibes about JBoss and our credibility/professionalism.


  
> Fix Getting Started Guide
> -------------------------
>
>                 Key: TOOLSDOC-253
>                 URL: https://issues.jboss.org/browse/TOOLSDOC-253
>             Project: Documentation for JBoss Tools and Developer Studio
>          Issue Type: Bug
>      Security Level: Public(Everyone can see) 
>          Components: Getting Started Guide
>    Affects Versions: 3.2.1.Final
>            Reporter: Vlado Pakan
>            Assignee: Isaac Rooskov
>             Fix For: 3.2.2.Final
>
>
> Please fix these errors: 
> http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Developer_Studio/4.1/html/Getting_Started_Guide/introduction.html
> - replace "But, many find these preconfigured tools offer significant time-savings and value" with "But, many find these preconfigured tools offering significant time-savings and value"
> http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Developer_Studio/4.1/html/Getting_Started_Guide/Installing_JBoss_Developer_Studio-Manual_Installation.html
> - replace "The Remove button will the remove the selected server from the list." with "The Remove button will remove the selected server from the list."
> http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Developer_Studio/4.1-/html/Getting_Started_Guide/extras_site.html
> - extras URL should not point to 4.1 extras instead of 4.0?
> http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Developer_Studio/4.1/html/Getting_Started_Guide/tech_previews.html
> - tech preview site have no component. Does that make sense then to give information about tech preview site? Should not be deleted this whole chapter?
> http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Developer_Studio/4.1/html/Getting_Started_Guide/db_programming.html
> - replace "There is quite a bit of AJAX in this application, but which we will explore further later on in the lab." with "There is quite a bit of AJAX in this application, we will explore AJAX further later on in the lab."
> http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Developer_Studio/4.1/html/Getting_Started_Guide/WebXML.html
> - replace "If you come back to Tree mode you will see that the changes made are automatically reflected in that mode." with "If you come back to Tree mode you will see that the changes made in source tab are automatically reflected in that mode."
> http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Developer_Studio/4.1/html/Getting_Started_Guide/DeployTheProject.html
> - Figure 7.11. Has description "Archive in Project Archives View" but should have "Archive in Package Explorer"
> http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Developer_Studio/4.1/html/Getting_Started_Guide/EditingTheJSPViewFiles2.html
> - this text is duplicated: "On the Palette click on inputText, drag the cursor over to the editor, and drop it inside the editor after the text.Switch to a Source mode and insert a <br/> tag after the <h:outputText> component to make a new line
> Click the Save button"

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira