updated api docs & tests