[JAVAEETUTORIAL-133] Tag terminology needs definitions and other fixes Created: 20/Aug/12 Updated: 06/Nov/12 Resolved: 06/Nov/12
|Reporter:||Kim Haase||Assignee:||Kim Haase|
|Remaining Estimate:||Not Specified|
|Time Spent:||Not Specified|
|Original Estimate:||Not Specified|
The section "Immediate Evaluation" in the Expression Language chapter (http://docs.oracle.com/javaee/6/tutorial/doc/bnahr.html#bnahs) mentions a tag handler, a concept not previously introduced.
The problem goes back as far as the section on the hello1 example in "Getting Started with Web Applications" chapter (http://docs.oracle.com/javaee/6/tutorial/doc/bnadx.html), which has a bullet that mentions the tags directory, tag files, and tag libraries without explaining what they are. In fact, the tags directory is no longer mentioned in the Java EE 6 platform spec and is associated with JavaServer Pages (JSP) technology; it is not in the illustration "Web Module Structure".
So this bullet item should be removed, and the terms "tag", "tag handler", and "tag library" need to be defined at appropriate points in the documentation.
|Comment by Kim Haase [ 20/Aug/12 ]|
Changes needed to Chapter 3:
Remove bullet item on "tags" directory in web applications, and remove mention of it from figure's alt description
Declaring Resource References section (http://docs.oracle.com/javaee/6/tutorial/doc/bnaeo.html#bnaeu): add CDI managed beans to last sentence of paragraph 2 (they accept resource injections), add a cross-reference to the "Resources and Resource Adapters" chapter (these aren't really related to this issue but should be done)
Remove taglib listeners and taglib tag handlers from table "Web Components That Accept Resource Injections" (they're still in the EE 5 tutorial, which covers JSP)
Changes needed to Chapter 4:
Introduce concept of tag handlers underlying component tags by adding a sentence near the beginning: "The tag libraries contain tag handlers that implement the component tags."
|Comment by Kim Haase [ 16/Oct/12 ]|
These fixes were checked in to SCCS on 9/21 but have not yet been put back to the tutorial workspace.
|Comment by Kim Haase [ 06/Nov/12 ]|
Changes have been put back to tutorial workspace.