Developing Programmers .com

I recently did some digging in the Subversion source code to find out answers to precedence questions that remained after re-reading the documentation for Subversion’s per-directory permission files (popularly referred to as ACLs). At work, this helped us a lot with ensuring our new graphical UI for permissions (an excellent tool developed by Mark George) [...]

I recently picked up a copy of Mike Gunderloy’s book, “Coder To Developer”. The title grabbed me right away because it’s exactly what this site is about! Reading it in fragments of time between work and home commitments, I was actually excited to try things after reading each chapter. The bulk of the book is [...]

In a court case against the European Competition Commission, Microsoft has allegedly had to spend 35,000 man hours, producing 12,000 pages of documentation to show how easy it is to write software that interoperates with theirs. They even had to re-hire some people who worked on the original software to help document it. This is [...]

This being the last Thursday before Christmas, it’s time to slack off a little. So I’m writing about a program that does pretty diagrams of “mind maps” that you can play with on your last day at work. It’ll be fun and might even be productive.

We all know we should document our code. But how much documentation is enough? This article explores three main kinds of documentation for programmers and suggests tools for producing API documentation automatically.