[JAVAEETUTORIAL-102] sequencing seems wrong Created: 24/Jun/12  Updated: 06/Nov/12  Resolved: 06/Nov/12

Status: Closed
Project: javaeetutorial
Component/s: doc
Affects Version/s: 6.0.7-5
Fix Version/s: 6.0.7-6

Type: Improvement Priority: Minor
Reporter: Brant Gurganus Assignee: Kim Haase
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


This issue occurs on the "Configuring Web Applications: The hello2 Example" page at http://docs.oracle.com/javaee/6/tutorial/doc/bnaeo.html. This is under the "Setting Context and Initialization Parameters" contents item. The sequencing is wrong for the "To Add a Context Parameter Using NetBeans IDE" section relative to "To Create a web.xml File Using NetBeans IDE". At this point in the tutorial, no web.xml file has been created and the tutorial specifically points out that hello2 does not need one to run out of the box. In that context, the web.xml file needs created first so that section should come prior to adding the context parameter.
In the current situation, you have to click the link within the "To Add a Context Parameter Using NetBeans IDE" section that goes to the "To Create a web.xml File Using NetBeans IDE" section which takes you away from the sequence of tutorial steps.

Comment by Kim Haase [ 26/Jun/12 ]

Thank you for your careful reading of this chapter. This fix should probably be made in conjunction with implementing your equally valid suggestions in JAVAEETUTORIAL-106.

Comment by Kim Haase [ 16/Oct/12 ]

I have removed the information about setting initialization parameters, since this task is almost never done and is too advanced for the introductory chapter. I did not change the location of the web.xml creation task, because this rarely has to be done for JavaServer Faces applications – NetBeans creates the web.xml file automatically.

Comment by Kim Haase [ 06/Nov/12 ]

Closing after putting back fix.

Generated at Wed Oct 07 13:41:10 UTC 2015 using JIRA 6.2.3#6260-sha1:63ef1d6dac3f4f4d7db4c1effd405ba38ccdc558.