Borklog: One entry

15 October 2000

Joel on Software has a new mini-essay, this time on how to write functional software specifications that people will actually read. What I found especially amusing is the section on not using a template for specs and not having every spec be identical. Recently for ArsDigita I wrote up a spec for the "poll application" (a legacy ACS module). Here's the Documentation Style Guide page, including templates to follow, and sure enough I wrote a hard-to-read (but uniform) specification.

admin@badgertronics.com