docs + less brittle tests