some documentation on the transaction model

fixes #27