api docs tweaks