more revisions to docs; started a page on defining transactions