On 3-10-2009 19:09, Vincent Le Chevalier wrote:
> Darren New wrote:
>>
>>> Then again, maybe it's the approach taken from the wrong side, and 
>>> the true proper way would be embedding the source code in the 
>>> documentation, not vice versa - if only for the psychological effect.
>>
>> Yes, exactly something like this.  We probably won't get there as long 
>> as the primary form of source code is ascii strings.
>>
> 
> Well, litterate programming does already exist... But the adoption rate 
> is not so high :-)

I have also used knuth's web system. It works as long as you want to 
design a nice document. The focus of programming shifts from coding to 
describing the right algorithms. We found it rather enjoyable to write 
the documentation and learned a lot more than we would if we had coded 
it straight away. However, it is IME not a style you can use if you have 
only many short periods of work and when that is under stress.

Post a reply to this message