Hide Forgot
Affects: Documentation (Ref Guide, User Guide, etc.) Date of First Response: 2010-03-24 13:26:02 project_key: SOA Please QE review, as per IRC discussion. Note that this document has not been changed in this cycle.
Reviewing the guide here: http://downtown.englab.bne.redhat.com/drafts/JBoss_Enterprise_SOA_Platform/4.3.CP03/Services_Guide/
Need some cleanup on the text here.
Attachment: Added: Screenshot.png
Comments (these were found during the 5.0 Services Guide review and are also in the 4.3 CP03 guide): Section: 12.5.2. ESBActionHandler contains definition of process-scope parameter that refers to globalProcessScope but the globalProcessScope is not defined -------------- Section 10 Content-Based Routing Using Smooks Comment: We need to add a note that says: There is no native support for Freemarker inside the ESB (no action, no gateway, etc), any use of Freemarker must be in the context of Smooks. Comment: All the graphics in this section are unreadable. -------------- Section - text just under figure 12.3 Text: Directly from JBoss Developer Studio, by clicking on the Deploy Process Archive button. This is visible in the "Deployment" view; Comment: We should remind the users about having to configure the upload servlet used by the deployer (See SOA-1586) -------------- Content-Based Routing Using Smooks Text: This release of the JBoss Service-Oriented Architecture Platform includes Smooks v1.1. This means that the split described above can be undertaken without defining the binding configurations that were demonstrated in Resources One and Two.) For details on how to do this, one needs to refer to the section entitled "FreeMarker Transforms using Node Models" in the Smooks User Guide . That document can be found at http://docs.codehaus.org/display/MILYN/Smooks+User+Guide . Comment: (Thanks to Tom for supplying this): The Node Model Templating functionality (templating without having to define a Java Model) is available in Smooks v1.1+. Sounds like the "split" config talked about in the comment is using a fully defined Java object model, which is fine, and the comment is just trying to tell the user that they also have this other option of using the Node Model functionality, hence doing away with the need to define a Java Object model. I think I'd just remove the reference to Smooks versions in the first comment and say.... "The split described above can be undertaken without defining the binding configurations that were demonstrated in Resources One and Two.) For details on how to do this see the section on <insert link to section on Node Models>" --------------
Fixed all of the problems in this section except for the issues with the graphics.
Len, as per our IRC discussion you might want to have a second look at this, now that I have backported some of the rewritten parts from 5.0 to lift the standard of grammar and spelling. Note I only did this in places - was very conservative.
Chapter 9 Content Based Routing Using Drools Can we rename this chapter: Content Based Routing Using JBoss Rules
Replaced references to Drools with JBoss Rules.
Verified in the doc on-line.