| Summary: | QE Review - Services Guide | ||||||
|---|---|---|---|---|---|---|---|
| Product: | [JBoss] JBoss Enterprise SOA Platform 4 | Reporter: | David Le Sage <dlesage> | ||||
| Component: | Documentation | Assignee: | David Le Sage <dlesage> | ||||
| Status: | CLOSED NEXTRELEASE | QA Contact: | |||||
| Severity: | high | Docs Contact: | |||||
| Priority: | high | ||||||
| Version: | 4.3 CP04 ER1 | ||||||
| Target Milestone: | --- | ||||||
| Target Release: | 4.3 CP04 CR1 | ||||||
| Hardware: | Unspecified | ||||||
| OS: | Unspecified | ||||||
| URL: | http://jira.jboss.org/jira/browse/SOA-2006 | ||||||
| Whiteboard: | |||||||
| Fixed In Version: | Doc Type: | Bug Fix | |||||
| Doc Text: | Story Points: | --- | |||||
| Clone Of: | Environment: | ||||||
| Last Closed: | 2010-04-01 23:15:50 UTC | Type: | Task | ||||
| Regression: | --- | Mount Type: | --- | ||||
| Documentation: | --- | CRM: | |||||
| Verified Versions: | Category: | --- | |||||
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |||||
| Cloudforms Team: | --- | Target Upstream Version: | |||||
| Attachments: |
|
||||||
|
Description
David Le Sage
2010-03-22 00:34:50 UTC
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. |