Resources

Resources

Papers

How Programmers Comment When They Think Nobody's Watching " Documentation is essential to software development. Experienced programmers know this well from having worked with poorly documented code. They wish to improve their documentation techniques and habits, but there is little consensus for them to follow. Somehow, the many different standards must be compared objectively. This desire motivates my work, which aims to better understand existing documentation practices. ... This work focuses exclusively on comments within the program code."

Blogs

The Low Quality of Scientific Code

Tools

• Concordion "Concordion is an open source tool for writing automated acceptance tests in Java (or .NET, Python, Scala, and Ruby)...Concordion acceptance tests are so readable they can double up as system documentation."
• Cucumber

Portals

• literateprogramming.com

Mailing list threads

• Proposing a new Clojure documentation system (in Clojure)
• deep thinking