docs: simplify apis where possible