CodeDown = Markdown as the universal language for program documentation

[Thomas Humiston]

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").