Documentation-Rons-Rules-For-Tools

From Slicer Wiki
Revision as of 14:01, 7 March 2011 by Kikinis (talk | contribs)
Jump to: navigation, search
Home < Documentation-Rons-Rules-For-Tools

Introduction

"Rules for tools" is an informal set of rules that developers should keep in mind when working on interactive tools for translational clinical research. If you follow them, you will create tools that many people will use.

  1. You make it, I break it
  2. Your tool works when it works on my laptop with my data. Until then, it's useless to me.
  3. I am lazy. Make my life easy. [1]
  4. No more than one parameter that I can set and if I need more than 20 seconds to figure out how to set the parameter, I won't!
  5. If I can take my lunch break while your algorithm is running, I won't return to it. [2]

How To Make Algorithms Robust

  • Build a case library with 10 or more cases
  • Use half for development, cycle through the cases daily
  • Use the other half for testing

References

  1. User friendliness:
    • Minimize the number of clicks
    • Minimize the distance my pointer has to travel
    • Have good default values for the parameter and I/O, and allow me to override.
  2. Performance Requirements
    • under a minute is good
    • 5 minutes are acceptable
    • 10 minutes or more are not