some updates to format doc