[Checkins] [zopefoundation/ZODB] ed3651: Documentation on transactions and threading.

[GitHub]

  Branch: refs/heads/transactions-and-threading
  Home:   https://github.com/zopefoundation/ZODB
  Commit: ed365135732ddcfaac68ba9605c47bee22ecddfe
      https://github.com/zopefoundation/ZODB/commit/ed365135732ddcfaac68ba9605c47bee22ecddfe
  Author: Jim Fulton <jim at zope.com>
  Date:   2016-09-09 (Fri, 09 Sep 2016)

  Changed paths:
    M CHANGES.rst
    M doc/articles/old-guide/prog-zodb.rst
    M doc/guide/index.rst
    M doc/guide/install-and-run.rst
    A doc/guide/transactions-and-threading.rst
    M doc/reference/index.rst
    A doc/reference/transaction.rst
    M doc/reference/zodb.rst
    M src/ZODB/Connection.py
    M src/ZODB/tests/testdocumentation.py

  Log Message:
  -----------
  Documentation on transactions and threading.

This adds documentatuon on transactions and threading concerns.

There are some topics, like application design and conflict resolution
that might want a deeper treatment, but would probably be better
handled through articles or dedicated topics. (I want to avoid
individual topics being too long or weedy to read, where practical.)

Writing this, I stumbled a bit over thread-local transaction managers.
For most applications, they don't add anything over accessing
transaction managers on connections and actually provide an
opportunity to fail. I'm convinced that it should be possible to do
most transaction management through connections and that the API
provided by transaction managers and the transaction package should be
reserved for distributed transactions.

I didn't mention gevent. I thik there should be a section on gevent,
but I think it should be written by someone who's used gevent with
ZODB. :)

Maybe there should also be a section or mention of using asyncio with
ZODB, pr maybe later.

Closes zopefoundation/zodbdocs#13
Closes zopefoundation/zodbdocs#16