javaeetutorial
  1. javaeetutorial
  2. JAVAEETUTORIAL-133

Tag terminology needs definitions and other fixes

    Details

    • Type: Bug Bug
    • Status: Closed
    • Priority: Major Major
    • Resolution: Fixed
    • Affects Version/s: 6.0.7-5
    • Fix Version/s: 6.0.7-6
    • Component/s: doc
    • Labels:
      None

      Description

      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.

        Activity

        Hide
        Kim Haase added a comment - - edited

        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."

        Show
        Kim Haase added a comment - - edited 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."
        Hide
        Kim Haase added a comment -

        These fixes were checked in to SCCS on 9/21 but have not yet been put back to the tutorial workspace.

        Show
        Kim Haase added a comment - These fixes were checked in to SCCS on 9/21 but have not yet been put back to the tutorial workspace.
        Hide
        Kim Haase added a comment -

        Changes have been put back to tutorial workspace.

        Show
        Kim Haase added a comment - Changes have been put back to tutorial workspace.

          People

          • Assignee:
            Kim Haase
            Reporter:
            Kim Haase
          • Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved: