[BUG] Lack of documentation for the new transaction object model

[wwahammy]

While @wwahammy has implemented parts of the transaction object model, he hasn't documented it fully. This issue is here to remind us that it needs to be done :)