Recently, one of our developers had a mini-rant about the new to properly document bugs in tickets. Apparently, writing “comments are broken” is incredibly unhelpful. Go figure. Of course, he’s dead right, without describing a problem completely it’s a hell of a lot harder to fix.

An alternate approach is presented in this oldie but goodie - a list of logbook entries between airline pilots and maintenance personnel.

Some of my favorites:

Problem as reported: Something loose in cockpit.
Service Response: Something tightened up in cockpit.

Problem as reported: Aircraft acting funny.
Service Response: Aircraft warned to “Straighten up, fly right and be serious.”

Enjoy.