Beefy Boxes and Bandwidth Generously Provided by pair Networks
There's more than one way to do things
 
PerlMonks  

comment on

( [id://3333]=superdoc: print w/replies, xml ) Need Help??
So what have I missed?

The fact that many core modules that you most likely use on a daily basis would set off plenty of red flags.

A few other points I think you should rethink:

  • it reinvents wheels, uses globals - sometimes an author doesn't want to depend on existing code (particularly if it's not a core module). Sometimes code is too slow (this matters, see perl if you disagree). There are good reasons for using globals! Strict rules of that sort rarely do anyone but the newest programmer any good.
  • or HTML::* - why? There are plenty of exceptionally good modules in that namespace (granted, I think they should almost all be in XHTML nowadays, but close enough).
  • The language is uncomfortable with perl terms: we pass in what is known as a "Hash Reference" - possibly a bad sign, but remember not all documentation is written for experts, explaining simple concepts probably doesn't belong in module docs (links would be better), but there's a lot of gray area here.

As for flags to add - how about tests? This is a major one I look for.

Most of all I'd advise you to check the source of modules you deem trustable, if it ends up being no good, take another look at the 'red flag' ones.


In reply to Re: CPAN Module Evaluation Red-Flags by Anonymous Monk
in thread CPAN Module Evaluation Red-Flags by bsb

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 romping around the Monastery: (3)
As of 2024-04-20 00:08 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found