in reply to A Peeve of Great Pettishness

I'm glad that made you feel better.

I'm also used to seeing '1.0' as the first real|production|valid release; my prejudice is that release 0.3.0 is, at best, in beta.

I also don't like release "numbers" that seem to be include random alphanumeric characters.

I've other rants, too, such as modules released with no documentation. Sorry, but I can't be bothered trying to figure out what Purple::Blovinator does by reading the code.

Since I wrote this I found out that there is actually a "purple" module, but not a Purple module. &abashed_grin;

emc

Replies are listed 'Best First'.
Re^2: A Peeve of Great Pettishness
by rje (Deacon) on Oct 28, 2005 at 17:43 UTC
    You've just lit a fire in me to create module Purple::Blovinator and submit it to CPAN.

    The name is sooo cool that it shouldn't be commented!
[reply]

      I agree! We need this module desperately.

      Blovination is an extremely useful and powerful tool

      emc

[reply]
Re^2: A Peeve of Great Pettishness
by BigLug (Chaplain) on Nov 01, 2005 at 10:27 UTC
    While we're having a rant about documentation ...

    If you're writing a module tell me exactly what it does in the simplest terms possible, sure it obvious to you what it does, but while it might solve my problem I won't know what it does unless you tell me!

    There are too many modules whose documentation is typically:

    Name

    Purple::Blovinator

    Description

    Implements lib_blovinator on the purple operating system. See lib_blovinator's documentation for interface.

    Firstly, I have no idea what lib_blovinator does. It may solve my problem. Secondly, while you may be able to map a C API to perl simply by reading the C docs, not everyone can - including myself.

    OK, I feel better now.

[reply]
[d/l]
[select]
      I fail to see the problem. If you can't understand lib_blovinator's documentation, it's unlikely to solve your problem anyway.

      Sure, it would be nice if there's more documentation. But people getting software for free who still whine it's too difficult for me, you must put more work into it, because I won't really irk me.

      Perl --((8:>*
[reply]

In Section Meditations