update the format and docs