ZODB Book Outline
Part one: getting started
This part will have an emphasis on getting an application up and running while making simple use of the ZODB. A developer who just needs to add a simple persistent layer to his application might have enough with this.
Introduction to ZODB
This will be a very short chapter, just to get things going. What is the ZODB. Maybe some bits about the NoSQL craze, how the ZODB has been doing that for more than 10 years. Why is the ZODB a nice tool to keep in your Python developer's arsenal and when is it a good fit for your apps?
Your first ZODB application
Installation and running the first app. The objective of this chapter is to let the reader do something that works immediately. Just the basics to get an app running. Not a lot of details here.
Working with the ZODB
A bit more involved explanation of how the ZODB works and a more useful sample application. This chapter will cover usage of the ZODB in detail.
The ZODB depends on the transaction package and understanding this package is very important to working effectively with it. This chapter introduces transactions, shows what happens when you commit or abort, describes what a conflict error is and explains why it's a good idea to avoid long running transactions.
Basic indexing and searching
The Catalog and indexes. I propose to use repoze.catalog here, which uses zope.index.
This chapter shows some common patterns for working with specific situations that come up when using the ZODB.
Packing, what it is, why it can take a long time, how garbage collection affects it. Automated packing. Backing up, automated back ups.
The ZODB cache, ZEO and replication services.
Part two - advanced topics
This will be a more in-depth review of techniques and concepts for ZODB development.
A more in-depth look at the ZODB internals
A little more information about how the ZODB works. At least enough stuff to understand the later chapters about storages and debugging.
Advanced transaction management
How to create data managers for working with other storages in the same transaction, how to best approach the need for well behaved, long running transactions.
Details about the FS storage and discussion of RelStorage and maybe DirectoryStorage. Different packing strategies across various storages.
Popular third party packages
Some of the most important packages for the ZODB will be described here.
Other indexing and searching strategies
Other catalog implementations, third party indexes and using external indexing solutions, like Solr.
Evolving schemas, creating custom indexes.
The debugging FAQ: frequent problems and suggested solutions
General debugging strategies and then a FAQ with common problems. For example, common traps like attempting to load an object state when the connection is closed.
Part three - ZODB API
The official public API will be documented here. This could serve as a really quick reference for developers. We might include APIs for some other modules, like transaction.