Dave Fayram wrote:
> I actually sat down and read this artcile. I'm blown away by some of
> the things he said. I'm so blown away that I am going to rant a little.
> I hope no one minds. <:)
> 
> For example:
> 
>>Any language or system that does not allow full flowing and
>>arbitrarily long comments is seriously behind the times. That
>>we use escape characters to "escape" from code to comment is
>>backwards. Ideally, comment should be the default, with a
>>way to signal the occasional lines of code.
> 
> 
> 
> What he said up there, that's crazy talk. Ramblings about Literate
> Programming aside, the idea that documentation should come before code
> is a serious mistake. Documentation exists to *document code*, code
> does not exist to follow documentation.

Hmm.  I often see code as being documentation dumbed-down enough for 
computers to understand.

Positing that documentation exists to document code, and that code does 
not exist to follow documentation, is begging the question.


James