revises id's to better explain the document