updated docs with transactions