Details

    • Type: New Feature New Feature
    • Status: Resolved
    • Priority: Critical Critical
    • Resolution: Fixed
    • Affects Version/s: 4.0_b60
    • Fix Version/s: 4.0_b81
    • Component/s: sample_apps
    • Labels:
      None

      Description

      We have some requirements to improve out-of-the-box Java EE 7 SDK ease of use. Specifically:

      • The Java EE 6 SDK offers a lot of documentation - API documentation, First Cup, GlassFish QuickStart, and the Java EE samples. However, locating these can be difficult for a new Java EE developer. In addition, the about_sdk.html file gives information about what the SDK artifacts are, but offers no recommendation as to the steps the user should take to learn Java EE.
      • There should be an index.html file in the top-level SDK directory with details what the SDK offers. The about_sdk.html file currently fulfills this role, but should be moved to the top-level directory ($SDK_HOME/index.html) and renamed to index.html. In addition, this file should also be updated to recommend to the user the steps they should take to learn Java EE 7.
        • Apparently there are actually two such files, one for the Full Profile (about_sdk.html) and the other one for the Web Profile (about_sdk_web.html). Need to figure out how to handle this (index.html and index_web.html)?
      • The docs & samples directories should be based off the top-level SDK directory. They are currently "buried" under the glassfish sub-directory and difficult for the user to find. Users often run "ls" or "dir" to determine what's available. The default documentation that ships with GlassFish (quickstart.html, features.html, etc) can remain in the glassfish/docs subdirectory. Example:
        $SDK_HOME/docs 
        $SDK_HOME/samples 
        $SDK_HOME/glassfish 
        
      • The existing Java EE 6 SDK links to the Java EE 6 tutorial online. The Java EE 7 SDK will bundle the Java EE 7 Tutorial PDF file and also link to the online HTML tutorial.
      • First cup (and tutorial) should go under $SDK_HOME/docs

        Issue Links

          Activity

          Joe Di Pol created issue -
          Joe Di Pol made changes -
          Field Original Value New Value
          Link This issue is related to GLASSFISH-19256 [ GLASSFISH-19256 ]
          Snjezana Sevo-Zenzerovic made changes -
          Fix Version/s 4.0_b76_EE7MS5 [ 16105 ]
          Fix Version/s 4.0 [ 10970 ]
          Description
          We have some requirements to improve out-of-the-box Java EE 7 SDK ease of use. Specifically:

          * The Java EE 6 SDK offers a lot of documentation - API documentation, First Cup, GlassFish QuickStart, and the Java EE samples. However, locating these can be difficult for a new Java EE developer. In addition, the about_sdk.html file gives information about what the SDK artifacts are, but offers no recommendation as to the steps the user should take to learn Java EE.
          * There should be an index.html file in the top-level SDK directory with details what the SDK offers. The about_sdk.html file currently fulfills this role, but should be moved to the top-level directory ($SDK_HOME/index.html) and renamed to index.html. In addition, this file should also be updated to recommend to the user the steps they should take to learn Java EE 7.
          *The docs & samples directories should be based off the top-level SDK directory. They are currently "buried" under the glassfish sub-directory and difficult for the user to find. Users often run "ls" or "dir" to determine what's available. The default documentation that ships with GlassFish (quickstart.html, features.html, etc) can remain in the glassfish/docs subdirectory. Example:
          {noformat}
          $SDK_HOME/docs
          $SDK_HOME/samples
          $SDK_HOME/glassfish
          {noformat}
          * The existing Java EE 6 SDK links to the Java EE 6 tutorial online. The Java EE 7 SDK will bundle the Java EE 7 Tutorial PDF file and also link to the online HTML tutorial.
          We have some requirements to improve out-of-the-box Java EE 7 SDK ease of use. Specifically:

          * The Java EE 6 SDK offers a lot of documentation - API documentation, First Cup, GlassFish QuickStart, and the Java EE samples. However, locating these can be difficult for a new Java EE developer. In addition, the about_sdk.html file gives information about what the SDK artifacts are, but offers no recommendation as to the steps the user should take to learn Java EE.
          * There should be an index.html file in the top-level SDK directory with details what the SDK offers. The about_sdk.html file currently fulfills this role, but should be moved to the top-level directory ($SDK_HOME/index.html) and renamed to index.html. In addition, this file should also be updated to recommend to the user the steps they should take to learn Java EE 7.
          *The docs & samples directories should be based off the top-level SDK directory. They are currently "buried" under the glassfish sub-directory and difficult for the user to find. Users often run "ls" or "dir" to determine what's available. The default documentation that ships with GlassFish (quickstart.html, features.html, etc) can remain in the glassfish/docs subdirectory. Example:
          {noformat}
          $SDK_HOME/docs
          $SDK_HOME/samples
          $SDK_HOME/glassfish
          {noformat}
          * The existing Java EE 6 SDK links to the Java EE 6 tutorial online. The Java EE 7 SDK will bundle the Java EE 7 Tutorial PDF file and also link to the online HTML tutorial.
          Joe Di Pol made changes -
          Priority Major [ 3 ] Critical [ 2 ]
          Joe Di Pol made changes -
          Link This issue is related to GLASSFISH-19438 [ GLASSFISH-19438 ]
          Snjezana Sevo-Zenzerovic made changes -
          Fix Version/s 4.0_b77 [ 16106 ]
          Fix Version/s 4.0_b76_EE7MS5 [ 16105 ]
          Joe Di Pol made changes -
          Description We have some requirements to improve out-of-the-box Java EE 7 SDK ease of use. Specifically:

          * The Java EE 6 SDK offers a lot of documentation - API documentation, First Cup, GlassFish QuickStart, and the Java EE samples. However, locating these can be difficult for a new Java EE developer. In addition, the about_sdk.html file gives information about what the SDK artifacts are, but offers no recommendation as to the steps the user should take to learn Java EE.
          * There should be an index.html file in the top-level SDK directory with details what the SDK offers. The about_sdk.html file currently fulfills this role, but should be moved to the top-level directory ($SDK_HOME/index.html) and renamed to index.html. In addition, this file should also be updated to recommend to the user the steps they should take to learn Java EE 7.
          *The docs & samples directories should be based off the top-level SDK directory. They are currently "buried" under the glassfish sub-directory and difficult for the user to find. Users often run "ls" or "dir" to determine what's available. The default documentation that ships with GlassFish (quickstart.html, features.html, etc) can remain in the glassfish/docs subdirectory. Example:
          {noformat}
          $SDK_HOME/docs
          $SDK_HOME/samples
          $SDK_HOME/glassfish
          {noformat}
          * The existing Java EE 6 SDK links to the Java EE 6 tutorial online. The Java EE 7 SDK will bundle the Java EE 7 Tutorial PDF file and also link to the online HTML tutorial.
          We have some requirements to improve out-of-the-box Java EE 7 SDK ease of use. Specifically:

          * The Java EE 6 SDK offers a lot of documentation - API documentation, First Cup, GlassFish QuickStart, and the Java EE samples. However, locating these can be difficult for a new Java EE developer. In addition, the about_sdk.html file gives information about what the SDK artifacts are, but offers no recommendation as to the steps the user should take to learn Java EE.
          * There should be an index.html file in the top-level SDK directory with details what the SDK offers. The about_sdk.html file currently fulfills this role, but should be moved to the top-level directory ($SDK_HOME/index.html) and renamed to index.html. In addition, this file should also be updated to recommend to the user the steps they should take to learn Java EE 7.
          * The docs & samples directories should be based off the top-level SDK directory. They are currently "buried" under the glassfish sub-directory and difficult for the user to find. Users often run "ls" or "dir" to determine what's available. The default documentation that ships with GlassFish (quickstart.html, features.html, etc) can remain in the glassfish/docs subdirectory. Example:
          {noformat}
          $SDK_HOME/docs
          $SDK_HOME/samples
          $SDK_HOME/glassfish
          {noformat}
          * The existing Java EE 6 SDK links to the Java EE 6 tutorial online. The Java EE 7 SDK will bundle the Java EE 7 Tutorial PDF file and also link to the online HTML tutorial.
          Joe Di Pol made changes -
          Description We have some requirements to improve out-of-the-box Java EE 7 SDK ease of use. Specifically:

          * The Java EE 6 SDK offers a lot of documentation - API documentation, First Cup, GlassFish QuickStart, and the Java EE samples. However, locating these can be difficult for a new Java EE developer. In addition, the about_sdk.html file gives information about what the SDK artifacts are, but offers no recommendation as to the steps the user should take to learn Java EE.
          * There should be an index.html file in the top-level SDK directory with details what the SDK offers. The about_sdk.html file currently fulfills this role, but should be moved to the top-level directory ($SDK_HOME/index.html) and renamed to index.html. In addition, this file should also be updated to recommend to the user the steps they should take to learn Java EE 7.
          * The docs & samples directories should be based off the top-level SDK directory. They are currently "buried" under the glassfish sub-directory and difficult for the user to find. Users often run "ls" or "dir" to determine what's available. The default documentation that ships with GlassFish (quickstart.html, features.html, etc) can remain in the glassfish/docs subdirectory. Example:
          {noformat}
          $SDK_HOME/docs
          $SDK_HOME/samples
          $SDK_HOME/glassfish
          {noformat}
          * The existing Java EE 6 SDK links to the Java EE 6 tutorial online. The Java EE 7 SDK will bundle the Java EE 7 Tutorial PDF file and also link to the online HTML tutorial.
          We have some requirements to improve out-of-the-box Java EE 7 SDK ease of use. Specifically:

          * The Java EE 6 SDK offers a lot of documentation - API documentation, First Cup, GlassFish QuickStart, and the Java EE samples. However, locating these can be difficult for a new Java EE developer. In addition, the about_sdk.html file gives information about what the SDK artifacts are, but offers no recommendation as to the steps the user should take to learn Java EE.
          * There should be an index.html file in the top-level SDK directory with details what the SDK offers. The about_sdk.html file currently fulfills this role, but should be moved to the top-level directory ($SDK_HOME/index.html) and renamed to index.html. In addition, this file should also be updated to recommend to the user the steps they should take to learn Java EE 7.
          ** Apparently there are actually two such files, one for the Full Profile (about_sdk.html) and the other one for the Web Profile (about_sdk_web.html). Need to figure out how to handle this (index.html and index_web.html)?
          * The docs & samples directories should be based off the top-level SDK directory. They are currently "buried" under the glassfish sub-directory and difficult for the user to find. Users often run "ls" or "dir" to determine what's available. The default documentation that ships with GlassFish (quickstart.html, features.html, etc) can remain in the glassfish/docs subdirectory. Example:
          {noformat}
          $SDK_HOME/docs
          $SDK_HOME/samples
          $SDK_HOME/glassfish
          {noformat}
          * The existing Java EE 6 SDK links to the Java EE 6 tutorial online. The Java EE 7 SDK will bundle the Java EE 7 Tutorial PDF file and also link to the online HTML tutorial.
          * First cup (and tutorial) should go under $SDK_HOME/docs
          Joe Di Pol made changes -
          Fix Version/s 4.0_b81 [ 16110 ]
          Fix Version/s 4.0_b77 [ 16106 ]
          Snjezana Sevo-Zenzerovic made changes -
          Status Open [ 1 ] Resolved [ 5 ]
          Resolution Fixed [ 1 ]

            People

            • Assignee:
              Snjezana Sevo-Zenzerovic
              Reporter:
              Joe Di Pol
            • Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: