Contradictory docs are the enemy of efficient token usage by AI. If you offer an API, help your users by cleaning up your docs 😬