Do you know the difference between "documentation" and "specs"? One of those is for real human beings who want to program. The other is for people engaged in selfish and pointless activities, activities that do not help other people, and who think it's -OFUN to write and rewrite and rewrite compilers.

Compiler notes are not "documentation". Comments in source code are not "documentation". Math puzzles on RC aren't "documentation". Advent calendars aren't "documentation". Specs that aren't finished and are always being edited or promised to be edited aren't "documentation".

How can I be more clear about this?