R1:b20ae2a07fcb

Document transactions in docs

Summary:
Also add some formatting and links.

Also fix test broken by D2393.

Test Plan:
diviner .

Reviewers: epriestley

Reviewed By: epriestley

CC: aran, Koolvin

Differential Revision: https://secure.phabricator.com/D2461