Beefy Boxes and Bandwidth Generously Provided by pair Networks
Come for the quick hacks, stay for the epiphanies.
 
PerlMonks  

comment on

( [id://3333]=superdoc: print w/replies, xml ) Need Help??

It's hard to go wrong with KISS as a basis. The successful design of a module (or library (or interface)) pretty much depends on either experience or empathy or both. This is basically a 'walk a mile in another's shoes' kind of thing and efforts to expand functionality beyond a simple model quickly fractalize into complexity. That said, another area to explore lies below the obvious user level, i.e. below fgrep etc. Sometimes it is not the higher functions a user wants, but rather the primitives used to build the higher level. If these are exposed clearly and cleanly in the module then you appease the user who wants a portion of what you've designed, but has something else in mind in terms of what to use it for. This is surprisingly difficult to do in a generic and style free manner. Which last brings up an important criteria for evaluating the entire module. Namely, how much does the intended user have to think like the module author in order to use the module? Obviously this should be minimized as much as can be without diminishing function.

So, short answer, yup KISS is good, elsewhere there be dragons!

–hsm

"Never try to teach a pig to sing…it wastes your time and it annoys the pig."

In reply to Re: KISS vs Feature set by hsmyers
in thread KISS vs Feature set by Masem

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post; it's "PerlMonks-approved HTML":



  • Are you posting in the right place? Check out Where do I post X? to know for sure.
  • Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:
    <code> <a> <b> <big> <blockquote> <br /> <dd> <dl> <dt> <em> <font> <h1> <h2> <h3> <h4> <h5> <h6> <hr /> <i> <li> <nbsp> <ol> <p> <small> <strike> <strong> <sub> <sup> <table> <td> <th> <tr> <tt> <u> <ul>
  • Snippets of code should be wrapped in <code> tags not <pre> tags. In fact, <pre> tags should generally be avoided. If they must be used, extreme care should be taken to ensure that their contents do not have long lines (<70 chars), in order to prevent horizontal scrolling (and possible janitor intervention).
  • Want more info? How to link or How to display code and escape characters are good places to start.
Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others rifling through the Monastery: (6)
As of 2024-04-18 02:55 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found