add format helper method and update docs