• Documentation (Ref Guide, User Guide, etc.)
    • Not Required
    • ASSIGNED

      Part III
      ---------

      59) 11. Overview
      Read this chapter to get a brief <-- Read this chapter for a brief

      60) 11.1 What is Internet Server API
      Inconsistent punctuation in the list; if you're going to end with a full stop, you need to have ", and" or "; and" at the end of the first bullet

      61) 11.1 What is Internet Server API
      Usage of first person seems jarring; this is generally not the style used in the rest of the book.

      62) 11.1 What is Internet Server API
      "The DLLs are registered with the web server which makes them available to use." --> "These DLLs must then be registered with the web server before they are available for use."

      63) 12.1 Prerequisites and Configuration Assumptions
      Why is this a massive section, but most preprequisites in the first half of the book are as tiny little formalparas? Consistency please.

      64) 12.1 Prerequisites and Configuration Assumptions
      The IMPORTANT note should probably be integrated into the steps rather than at the beginning of the chapter. (Which I think ought to be Step 4 of 12.2.)

      65) 12.2 Configure Server Instance as a Worker Node – Prerequisites
      Step 1 – specifies use of the default profile. Is this the only profile supported? If so, remove "you want to configure as a worker node". If it's not the only supported profile, then the directive to copy default profile specifically should be removed. You can use default as an example after the main directive. Same again for subsequent steps – I'd make a main directive that summarizes what they are doing and why, followed by a specific example.

      66) Task: Define ISAPI Filter
      Not immediately clear what the filter will do or why you are defining it. Screenshots would be nice, if anyone has licensed products around.

      67) Task: Define ISAPI Filter
      Master Server or Master server? Be consistent.

      68) Task: Define ISAPI Filter – Step 5
      Is the location of the executable always C:\connectors\jboss-ep-5.1\native\sbin\isapi_redirect.dll?

      69) Task: Define ISAPI Virtual Directory
      Not immediately clear why this needs to be done. Perhaps a summary of the configuration required at the beginning of Ch. 12 would be useful to orient people.

      70) Task: Define ISAPI Virtual Directory – Step 1
      Missing closing full stop.

      71) Task: Define ISAPI Virtual Directory – Step 2
      Again, is this ALWAYS the path?

      72) Task: Define ISAPI Virtual Directory – Step 4
      Missing full-stop.

      73) Task: Define ISAPI Web Service Extension
      Bleh @ difference in cases between a button and a window – I'm assuming this is present in the software, but still.

      74) Task: Define ISAPI Web Service Extension – Step 2
      Missing "exactly as written" used in previous procedures. Also, is this always the path?

      75) 12.4 Microsoft IIS 7 Initial Clustering Configuration – Terms
      URL at the end of the definition is not a hyperlink. Also, why does only this chapter have a Terms section?

      76) Task: Define a JBoss Native ISAPI Restriction – Step 1
      "Start -> Run, then type inetmgr." <- I think you also need to hit Enter or click Run afterward.

      77) IMPORTANT: Task: Define a JBoss Native ISAPI Restriction – Step 2
      Ends abruptly. Opens in the what?

      78) Task: Define a JBoss Native ISAPI Restriction – Step 5
      Is this always the path? Also, the spacing around the "jboss" value is too wide (spaces inside and outside the tag?).

      79) Task: Define an JBoss Native Virtual Directory
      s/an/a

      80) Task: Define an JBoss Native Virtual Directory – Step 2
      Missing full stop after (exactly as written). Is this path always the same?

      81) Task: Enable the ISAPI-dll Handler – Step 1
      Ends abruptly.

      82) Task: Enable the ISAPI-dll Handler – Step 4
      Missing full stop.

      83) Task: Configure ISAPI to serve a Basic Cluster – Step 1
      Double spacing around the directory. Append to, not append into.

      84) Task: Configure ISAPI to serve a Basic Cluster – Step 2
      "... has an abstract directory name containing images" --> "has an abstract directory name, and contains images"

      85) Task: Configure ISAPI to serve a Basic Cluster – Step 3 & 4
      Append to, not into.

      86) Task: Configure ISAPI to serve a Basic Cluster – Step 6
      Is there a default location for the log_file property? We should tell people this. Also, tell them what exactly they are meant to be "verifying" about the logs.

      87) Task: Configure ISAPI to serve a Load Balancing Cluster
      Load-Balancing

      88) Task: Configure ISAPI to serve a Load Balancing Cluster – Step 1
      Directory has extra spaces around it

      89) Task: Configure ISAPI to serve a Load Balancing Cluster – Step 3 & 4
      Append to, not into.

            rdickens_jira Russell Dickenson (Inactive)
            rhn-ecs-lbailey Laura Bailey
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved:

                Estimated:
                Original Estimate - 2 hours
                2h
                Remaining:
                Remaining Estimate - 2 hours
                2h
                Logged:
                Time Spent - Not Specified
                Not Specified