add docs and misc items; ignore data from version control; tweak readout handling; improve readability