fix validation for non-transaction documents; readme improvements