more wishful docs and test stubs