added api docs #2