Beefy Boxes and Bandwidth Generously Provided by pair Networks
The stupid question is the question not asked

Comment on

( #3333=superdoc: print w/replies, xml ) Need Help??
I've hesitated posting here since I've recently made an ass of myself, but here 'ya go ...

I think that two valid points have been brought up in this thread. The first is that code posted to CPAN should be of a specific quality. As HyperZonk said, at best our is of "Beta" quality. This, to my mind, is not appropriate material to be posted to CPAN. There is some really good code here, but I wouldn't want the responsibility of having my own code that I post here be available for public consumption as with CPAN.

The implicit sense of responsilibity that comes from authoring something that's available for download might in fact cause a decrease in the amount of snippets that are available here. A person (me, for example ... though in my case this might be a good thing) might think twice about posting something if that code were instantly availible by the amount of people who hit download sites like CPAN. Like I said, those people are expecting a certain code-quality that isn't implied here.

The second point relates to the first: we need a mechanism that is relatively nonobtrusive; something not too different from the format we have now; what people are used to. If an extra burden is placed on people for formatting, pod'ing, whatever, it won't be a smooth or easy transition; and many just won't do it.

What we really need, I think, is some intelligent node-crawlers; a new SuperSuperSearch that is specifically designed to trawl though nodes looking for <code> tags, and the stuff between them.

Some of the best code around here are snippets, things like Japhy's response to a post of mine

sub union { my %seen; @seen{@$_} = () for @_; return keys %seen; } sub intersection { my %seen; for (@_) { $seen{$_}++ for @$_ } return grep $seen{$_} == @_, keys %seen; }

This is the type of code that we should be concerned about being found. Unfortunately to do that, we need to come up with a method of cataloging and searching the code.

Something we can start easily enough with is to catalog by function name. That combined with a full-text search of the node (and possibly the entire thread) should turn up quite a few hits; especially since most people give their example subs logical and descriptive names (like, ahem, Japhy's above-quoted example). Adding the ability to search in ## Comments for text seperately than function name searching would be a really good method, I think.

So, what I'm saying is that we should think not off adding an outside (CPAN) method of accessing our code, but instead create a local method of searching it.

And after all, isn't that the True Way of a Monestary? Isn't there some sort of implied rule that you must be willing to look for the answer before receiving it? I've never known Librarian-monks to ask for outside help in cateloging their books :)

mr.nick ...

In reply to Re: Re: this place should define a relation to CPAN soon by mr.nick
in thread this place should define a relation to CPAN soon by princepawn

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

  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.
  • Log In?

    What's my password?
    Create A New User
    and all is quiet...

    How do I use this? | Other CB clients
    Other Users?
    Others chilling in the Monastery: (9)
    As of 2018-05-28 08:15 GMT
    Find Nodes?
      Voting Booth?