Red Hat Bugzilla – Bug 821969
Developer Guide Information Set
Last modified: 2012-08-15 12:44:53 EDT
FYI, a current draft of the Developer Guide exists here:
1. The existing information about APIs used in JBoss Data Grid 6 based on the information available for ISPN in the community docs. This includes information about usage, benefits, concepts, configs, etc. for each API.
2. The javadocs are a great source for classes and their attributes for developers.
Aside from these two information sets, I wonder if there is anything (possibly really obvious for actual developers) else that *should* be documented in the developer guide but is not really known to me.
Copying myarboro, asantos and ttarrant on this bug.
Adding remote interfaces to Developer guide and marking this bug modified.
Prabhat's QE feedback:
prabhat> 2.3.2 Need more code
<prabhat> Chapter 5: Need more code
<prabhat> Chapter 6: Need more code
<prabhat> Section 9.2.1 is not needed.
<prabhat> Entire chapter 10 is very detailed and is an example of how other chapters ideally should be.
<prabhat> I believe a separate chapter for Transaction is needed
(In reply to comment #2)
> Prabhat's QE feedback:
> prabhat> 2.3.2 Need more code
Added the following topics:
* Flag Usage with the AdvancedCache Interface
* Using the ConfigurationBuilder API to Configure the Cache API
* Custom Interceptors [QE'd by Martin in Admin & Config Guide]
* Custom Interceptor Design [QE'd by Martin in Admin & Config Guide]
* Adding Custom Interceptors Programatically [QE'd by Martin in Admin & Config Guide]
* Adding custom interceptors declaratively [QE'd by Martin in Admin & Config Guide]
> <prabhat> Chapter 5: Need more code
Adding following topis:
* The ConfigurationBuilder API
* Enable the CacheStore using the ConfigurationBuilder API
Created following topics:
* Programmatically Create a CacheManager and Replicated Cache
* Create a Customized Cache Using the Default Named Cache
* Create a Customized Cache Using a Non-Default Named Cache
* Using the Configuration Builder to Create Caches Programmatically
* Globally Configure the Transport Layer
* Globally Configure the Cache Manager Name
* Globally Customize Thread Pool Executors
* Cache Level Configuration for the Cluster Mode
* Cache Level Eviction and Expiration Configuration
* Cache Level Configuration for JTA Transactions
* Cache Level Configuration Using Chained Persistent Stores
* Cache Level Configuration for Advanced Externalizers
* Cache Level Configuration for Custom Interceptors
> <prabhat> Chapter 6: Need more code
Created the following:
* The Externalizable API Usage
* The Externalizable API Configuration Example
* AdvancedExternalizer Example
* Linking Externalizers with Marshaller Classes
* Externalizer Identifier
* Registering Advanced Externalizers
* Register Multiple Externalizers Programmatically
> <prabhat> Section 9.2.1 is not needed.
> <prabhat> Entire chapter 10 is very detailed and is an example of how other
> chapters ideally should be.
Why, thank you. ;)
> <prabhat> I believe a separate chapter for Transaction is needed
We have the following chapter in the Admin and Config guide. Is this what you think is required here as well:
16.1. Java Transaction API Transactions
16.2. Transactions Spanning Multiple Cache Instances
16.3. Transaction/Batching and Invalidation Messages
16.4. The Transaction Manager
16.4.1. JTA Transaction Manager Lookup Classes
16.4.6. Use the Transaction Manager
188.8.131.52. Obtain the Transaction Manager From the Cache
184.108.40.206. Transaction Configuration
220.127.116.11. Transaction Manager and XAResources
18.104.22.168. Obtain a XAResource Reference
22.214.171.124. Default Distributed Transaction Behavior
16.5. Transaction Synchronization
16.5.1. Transaction (JTA) Synchronizations
16.5.2. Enable Synchronization
Re: Transactions. Added Transactions to the following chapter:
Misha, thanks for these update and docs look more beefy.