|
|
| Welcome to the Monastery | |
| PerlMonks |
Re: Ingy's "Swiss Army Light Sabre" - or, "how do you design your APIs?"by EvdB (Deacon) |
| on Mar 23, 2004 at 12:51 UTC ( #338972=note: print w/ replies, xml ) | Need Help?? |
|
My favorite test for an API is "Can I remember how to use this after a week and in a hurry without the docs?". If I can remember the method names and the arguments then the API works for me. If I need the docs open all the time then the API is wrong. Obviously some things are more complicated than others but this is a good start. --tidiness is the memory loss of environmental mnemonics
In Section
Meditations
|
|
||||||||||||||||||||