begin fleshing out api docs