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??
Spring is well in the air by now (in this corner of the globe anyway), and it seems to be time for the annual Spring Clean Question about the Code Catacombs (not, I hasten to add, the True Catacombs - I'm not venturing down there without a map).

The proliferation of code in the Monastery is marvellous - new programs are added to the catacombs every few days, to say nothing of CUFP's, Snippets etc. Some are useful -some not so - to take two examples sitting side-by-side in the CGI section. And there's the rub. How did I know?

Obviously, in the two cases there, it's rather obvious. Well, it is to anyone that read the comments, or voted and saw the node reputation, or understood the code. That's you lot out of the way (I generally assume that anyone reading Discussions has been to the monastery before {g} ) - but what about the rest?

Alice: "Hey - there's some neat code here that does just what my teach +er asked me to do." Bob: "Is it any good?" Alice: "It's from PerlMonks - it must be. It was 4th fom the top. Some + people were arguing about it, but look! It works for question 3, so +who cares?" Bob: "Give it here - I'll change the variable names so he won't know.. +."

There's been discussion before about the monastery disseminating Cargo Cult code. I'm not asking for a cull or anything, but I think slight improvements to the way the catacombs are indexed and presented could help matters greatly. At present, the individual sections simply list script titles - sometimes self-evident, sometimes not. The only way to find out how useful / accurate / related-to-your-problem a script might be is to read the node itself, and all the replies, and probably try it out. Great fun when you're just browsing around, but not the most comprehensive of catalogues.

If programs were simply listed with a 'standard' PM title bar, with author / reply count (and categories - useful if looking for Win32/Networking code or something), this would help. Adding the description, as in the 'New Code' section, would help further (possibly chopped at x characters, or something). And dare I say...order by reputation? That may move this out of the way of merlyn's watchful gaze. :)

Sorry for yet another "can we have shift(@my_great_ideas) in the Monastery" discussion, but monk's gotta say what a monk's gotta say. I'll leave the bigger "can we catalogue every piece of code in the building" Discussion for another year though...

Cheers,
Ben.


In reply to Down in the darkness, treasure lies. by benn

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 pondering the Monastery: (5)
As of 2024-04-26 07:54 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found