doc is ready for the new api refactoring