update docs
flakes, test stubs