updated docs on format