CodeDown = Markdown as the universal language for program documentation

Thomas Humiston tom at
Mon Apr 11 23:16:10 EDT 2011

On 11 Apr 2011, at 3:05 PM, Sherwood Botsford wrote:

> In one of the few programming courses I had, the instructor had us

> write the user manual first. THEN write the top level description

> of the program, including documenting the algorithms. ONLY then

> could we write the program. After we had to correct the previous

> levels.

Fantastic. As a general principle, that sounds like probably the only
way to keep the inmates from running the asylum if they're not using
Alan Cooper's 'personas' approach (detailed in his book "The Inmates
Are Running the Asylum").

More information about the Markdown-Discuss mailing list