Rework documentation with a note tag and an explanation.