in reply to RE (7): Should I use $ and $# ?
in thread Should I use $ and $# ?

> (BTW it looks like the documentation on this site is also 5.003.)

I know this is a small point to pick at, but it has been bugging me, and it has been brought up more than once. Our Head Honcho has put a lot of work into this site, and if you have ideas on how to improve it, by all means post something to the Perl Monks Discussion section. Updating the site documentation, for example, is a very good and very important idea - it's just a shame to see it buried deep inside a nested post as <disclaimer> what seems to me as </disclaimer> somewhat of a dig against the site.

Replies are listed 'Best First'.
RE (tilly) 9: Should I use $ and $# ?
by tilly (Archbishop) on Aug 13, 2000 at 07:44 UTC
    I am sorry I cannot respond to this in full. In 24 hours I need to be on the other side of the continent giving a talk and I don't have room for much else.

    But I was not trying to slam this site. No matter what this site does, it will be wrong for someone. I have seen people here using 5.004, 5.005, and 5.6. These are all different. You simply will not get a single reference, be it a book or a website, to conveniently document all of these in any straightforward way for people to use. Whether or not this documentation is updated, it is a mistake to encourage people to rely on it.

    Instead what I would love to see is to have every page taken from Perl's documentation have up top a disclaimer like this:

    This documentation may be for a different version of Perl than what you have.
    For more accurate documentation please type perldoc (whatever)
    Letting people know the problem and encouraging them to get the answer from the right place would IMNSHO do far more good than telling them to rely on this site and trying to be all things to all people.

    BTW you should see Tom Christiansen rant on this topic some time...

Re (9): Should I use $ and $# ?
by nuance (Hermit) on Aug 13, 2000 at 06:20 UTC
    I don't see how you could possibly read it as a dig against the site. The whole thrust of the argument was, don't use any documentation as absolute for your site, except that which was installed along with the version of perl that you have.

    "Updating" the documentation on the site even to 5.6 does not solve that problem since even then it still only applies to the people who have 5.6 installed.

    Regards

    Nuance