Bug 779138 (SOA-1536)

PDF attached for Technical Review

Attachment: Added: JBPM_Reference_Guide.pdf

Looking at the book here:

http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Enterprise_SOA_Platform/5.0.0/html/JBPM_Reference_Guide/

That completes the QE pre-beta doc review - assigning back to Darrin.

5.0.0 Beta1 doc is available on http://redhat.com/docs/JBoss_SOA_Platform/

Link: Added: This issue depends SOA-1907

Update - Feb 3

From David - changed sections to review:

<dlesage> ldimaggi_home  With regard to the jBPM Reference Guide, the chapters I rewrote are:
<dlesage> "Introduction" through to "The Context" (that is pages 1-57 of current PDF
<dlesage> didn't do Task Management
<dlesage> Then skipped to do
<dlesage> Scheduler
<dlesage> Aynchronous Continuations
<dlesage> Business Calendar
<dlesage> Email Support
<dlesage> Logging
<dlesage> and Security.
<dlesage> I did NOT do:
<dlesage> jBPM Process Definitions
<dlesage> Test Driven Development
<dlesage> Pluggable Architecture
<dlesage> Business Process Simulation
<dlesage> ldimaggi_home  Hope that helps.
<dlesage> ldimaggi_home  Here is the current build:
<dlesage> http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Enterprise_SOA_Platform/5.0.0/html/JBPM_Reference_Guide/

===========================================================================

Per Tom's suggestion in SOA-1907 - we should delete these sections/chapters:

* Section "1.7.  The JBoss jBPM Job Executor"
* Section 4.1.3.  Managed Transactions
* Section 4.1.4. "Injecting" the Hibernate Session
* Section 4.1.5.  Injecting Resources Programmatically
* Section 4.1.6. Advanced API Usage
* Section 4.2.  Configuring the Persistence Service except for following sections:
  - 4.2.5.  Database Compatibility
  - 4.2.6.  Combining Hibernate Classes
* Section 5.2. jBPM Enterprise Configuration
* Section 5.3.  Hibernate Enterprise Configuration
* Section 5.4.  Client Components
* Section 7.6.  Customizing Variable Persistence
* Chapter 15 Security
* Chapter 17. Pluggable architecture
* Chapter 18. Business Process Simulation

In section 4.1.2. Convenience Methods on JbpmContext, this first piece need to be removed:
"
In this section, it is presumed that the reader's configuration includes a persistence service similar to this one (found in the example src/config.files/jbpm.cfg.xml configuration file):
<jbpm-configuration>
    <jbpm-context>
        <service name='persistence'
          factory='org.jbpm.persistence.db.DbPersistenceServiceFactory' />
    </jbpm-context>
</jbpm-configuration>
"

Comments:

--------------------------------------

Section: 1.2. The jPDL Suite

Comment: The list of subdirectories in the document is incorrect - in ER8, in jboss-soa-p.5.0.0/jbpm-jpdl - the subdirectories are:

config
database
deploy
designer
examples
lib
src

--------------------------------------

3.4. Logging Optimistic Concurrency Exceptions

Text:
<boolean name="jbpm.hide.stale.object.exceptions" value="false" />

Comment:
Should be:
   <boolean name="jbpm.hide.stale.object.exceptions" value="false" />

--------------------------------------

I have made all of the requested changes, pending any further work that needs to be done based on outcomes of our  meeting.

NOTE:  We are not accepting any further QE feedback, unless they are mission-critical issues that would result in data loss.  We are closing this stage of the process for this release.