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 not half-baked at all. I think it's a great idea

Thanks.

Doesn't matter what the 'weekly' challenge is...

I think it does ... but I'll come back to that.

Perhaps list a known bug once per week that as a collective, we can look at and help the p5p.

I've been down that route in the past; and it is not an easy in. Even when you have a very clearly defined and repeatable bug; a minimal demonstrative testcase; the appropriate tools (debugger etc.) and the knowledge of using them; you still need to know your way around the perl codebase and internals at a pretty intimate level to stand any chance.

That's a big ask. And even if you get that far, the fact is that finding the source of the bugs is the minor part of the problem; and one that the experienced p5p guys will do so far faster than any of us.

The big problem is fixing them in a way that is commensurate with the policy; proving that the fix is commensurate; and then championing the fix through the p5p 'process'.

It is a) very hard; b) not for the faint of heart; c) apt to annoy p5p if you don't know their ways; d) intensely frustrating when all your work is reject for reasons you do not agree with. There is no appeals process!

Perhaps a couple of docs get thrown up once per week... we look through and make sure the doc says what the code actually does, or better, we write patches for the docs where we know tricks that may or may not be bugs (but will never go away due to perlpolicy) that others may not know about because it's not listed, or not listed prominently enough.

You (or I) can do that now; but documentation-by-committee is a frustrating and fruitless exercise. If you've been around here long enough to have witnessed one or more of the 'pedant wars' -- try super-searching for "array context" with author ikegami -- then you'll understand one the reasons.

Another is that critique requires a lot less effort than composition. It is really disheartening to expend the (for me at least) considerable effort required to construct what you consider to be a concise and lucid description of something only to have it picked over and trashed by the 'I've an opinion and I'm gonna express it' crowd.

Better to write your doc patch in isolation and if it gets incorporated, it then requires an equal expenditure of effort by someone to 'correct' it. If that happens, even if you disagree, the fact that at least one person felt strongly enough to construct and champion that correction; and at least one more agreed sufficiently to apply it; means you can probably accept that.

Doesn't matter what the 'weekly' challenge is... [Part deux]

A long time ago, Dominus used to post his Quiz Of The Week, but it is a thankless task.

After QotW dried up, I've tried posting a few challenges, but in the absence of a real-word problem for inspiration, it's really surprisingly hard to come up with something interesting, challenging. Even harder to find something for which the result has the potential to be useful.

On the other hand, the opcodes are clearly defined -- even if the definition is complex -- and any result that passed muster, would definitely be useful. And there are plenty of them. They have the potential to provide much entertainment for as many monks that can see past that it was I that proposed this.

Even if none of them ever produced anything worthy (or accepted) to the p5p process; the challenges would be so much better than watching cat videos or playing sudoku for those of us that would rather expend our downtime programming than watching reality TV or bad drama.

If 2 or 3 of the major opcodes got significantly improved by the expenditure of Monk's leisure activity that'd be a real bonus.

And if as a result of their participation in a no-pressure, have-fun, while-away-that-down-time-pleasurably activity, resulted in a couple-or-three Monks acquiring the knowledge, skill and confidence to risk subjecting themselves to p5p scrutiny, who looses?


With the rise and rise of 'Social' network sites: 'Computers are making people easier to use everyday'
Examine what is said, not who speaks -- Silence betokens consent -- Love the truth but pardon error.
"Science is about questioning the status quo. Questioning authority". The enemy of (IT) success is complexity.
In the absence of evidence, opinion is indistinguishable from prejudice.

In reply to Re^6: (Placeholder) Imagine! by BrowserUk
in thread (Placeholder) Imagine! by BrowserUk

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 perusing the Monastery: (10)
As of 2024-04-18 08:06 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found