update docs, first attempt at repairing tests