Stefan Adams

• Website: stefan.adams.fm
• About:

Recent Actions

• Posted Meet jp to Stefan Adams

  Welcome

  Please welcome the latest JSON tool for the command line: jp!

  jp (mostly named from the Mojolicious class Mojo…

• Commented on Bit Rot Thursday
  Thanks for this great piece of advice! Do you think you could link to an example (or two or three) "design spec" of yours? I'd be very interested to see this process. I've never seen anyone else's design spec and...

Comment Threads

• Zoffix Znet commented on Bit Rot Thursday

  I am myself new to the idea, so maybe I'm not the best person to give specs, but I have two examples for consideration (below). Your "spec" basically should outline how the code should work **from the perspective of the user**. So you kinda try to imagine whether using your code will be nice and pleasant or are there issues you've not considered.

  1) IRC::Client that I started hacking on without any specs. I now have to rewrite most of the event handling code because when I tried to actually use it, I found it too annoying and low-level.

  2) Test::When that I started by writing…

• Jakub Narebski commented on Bit Rot Thursday

  Do you think you could link to an example (or two or three) "design spec" of yours? I'd be very interested to see this process. I've never seen anyone else's design spec and it would be interesting to get an idea of what that would look like for someone else?

  I recommend seminal "Painless Functional Specifications" series by Joel Spolsky, available free on-line at:

  http://www.joelonsoftware.com/articles/fog0000000036.html