FYI, a current draft of the Developer Guide exists here: http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Data_Grid/6/html/Developer_Guide/index.html Some context: 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. Removed. > <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. Transactions 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.2. DummyTransactionManagerLookup 16.4.3. JBossStandaloneJTAManagerLookup 16.4.4. GenericTransactionManagerLookup 16.4.5. JBossTransactionManagerLookup 16.4.6. Use the Transaction Manager 16.4.6.1. Obtain the Transaction Manager From the Cache 16.4.6.2. Transaction Configuration 16.4.6.3. Transaction Manager and XAResources 16.4.6.4. Obtain a XAResource Reference 16.4.6.5. 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: http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Data_Grid/6/html/Developer_Guide/chap-The_Batching_API.html
Misha, thanks for these update and docs look more beefy.