Ask HN: What would make documenting your code easier?

I'm fleshing out an idea that would improve how you manage documenting your code. Specifically around preventing stale comments/READMEs.

Is there anything that you as a programmer feel would make documenting your code easier or less painful?