Bug 779138 (SOA-1536) - Beta1 QE Review: jBPM Reference Guide
Summary: Beta1 QE Review: jBPM Reference Guide
Keywords:
Status: CLOSED NEXTRELEASE
Alias: SOA-1536
Product: JBoss Enterprise SOA Platform 5
Classification: JBoss
Component: Documentation
Version: 5.0.0 GA
Hardware: Unspecified
OS: Unspecified
high
high
Target Milestone: ---
: 5.0.0 GA
Assignee: David Le Sage
QA Contact:
URL: http://jira.jboss.org/jira/browse/SOA...
Whiteboard:
Depends On: SOA-1907
Blocks:
TreeView+ depends on / blocked
 
Reported: 2009-10-19 09:44 UTC by Dana Mison
Modified: 2010-02-24 22:07 UTC (History)
0 users

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2010-02-24 22:07:49 UTC
Type: Task


Attachments (Terms of Use)
JBPM_Reference_Guide.pdf (993.90 KB, application/pdf)
2009-10-19 09:46 UTC, Dana Mison
no flags Details


Links
System ID Private Priority Status Summary Last Updated
Red Hat Issue Tracker SOA-1536 0 None None None Never

Description Dana Mison 2009-10-19 09:44:51 UTC
Affects: Documentation (Ref Guide, User Guide, etc.)
Date of First Response: 2009-12-10 13:58:14
project_key: SOA

jBPM Reference Guide attached for QE

Comment 1 Dana Mison 2009-10-19 09:46:22 UTC
PDF attached for Technical Review

Comment 2 Dana Mison 2009-10-19 09:46:22 UTC
Attachment: Added: JBPM_Reference_Guide.pdf


Comment 5 Len DiMaggio 2009-12-10 19:11:53 UTC
That completes the QE pre-beta doc review - assigning back to Darrin.

Comment 6 Dana Mison 2009-12-17 08:09:00 UTC
5.0.0 Beta1 doc is available on http://redhat.com/docs/JBoss_SOA_Platform/

Comment 7 Len DiMaggio 2010-02-03 13:00:39 UTC
Link: Added: This issue depends SOA-1907


Comment 8 Len DiMaggio 2010-02-03 13:03:04 UTC
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>
"

Comment 9 Len DiMaggio 2010-02-03 15:14:53 UTC
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:
&lt;boolean name="jbpm.hide.stale.object.exceptions" value="false" /&gt;

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

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

Comment 11 David Le Sage 2010-02-04 00:39:18 UTC
I have made all of the requested changes, pending any further work that needs to be done based on outcomes of our  meeting.

Comment 12 David Le Sage 2010-02-05 04:48:11 UTC
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.


Note You need to log in before you can comment on or make changes to this bug.