api docs overhaul