more fixes to new api and docs