Proposal Topical Docs

The idea here is to create documention/help content that is topical - focused on a particular topic or area.

Here is a working list of proposed topical guides:

• Persistence Contexts - Session, EntityManagers and Transactions
• Value Mappings - Types, AttributeConverts and the BasicTypeRegistry
• Services and Registries
  • Work in progress - https://github.com/hibernate/hibernate-orm/blob/master/documentation/src/main/asciidoc/topical/registries/ServiceRegistries.adoc
  • see Strong's work at https://gist.github.com/stliu/6920562
• Database Portability
• Bytecode Enhancement Feature-set
• Examples and usage for each extension point contract - 5.0 yes, 4.x no