more concise api docs