Beefy Boxes and Bandwidth Generously Provided by pair Networks
Keep It Simple, Stupid
 
PerlMonks  

perldoc.perl.org needs a facelift?

by EvanCarroll (Chaplain)
on Feb 05, 2019 at 19:49 UTC ( #1229431=perlmeditation: print w/replies, xml ) Need Help??

Where is the source code for this site? Is this another search.cpan thing where no one really knows what the story is? Is the site open source? Why when you click on a link is there neither an ability to view the source code for the module, or to link back to metacpan
https://perldoc.perl.org/File/stat.html
With MetaCPAN mature now, wouldn't it be in the best interests of the Perl community to redirect all of those links to metacpan and shut the site down?
Note it's not even current that doc on File::stat is 5.26. The latest release (current on meta.cp) is 5.28 (released June 23, 2018)


Evan Carroll
The most respected person in the whole perl community.
www.evancarroll.com

Replies are listed 'Best First'.
Re: perldoc.perl.org needs a facelift?
by choroba (Bishop) on Feb 05, 2019 at 19:55 UTC
    The history behind perldoc.perl.org is complicated. For example, there's a GitHub repository that seems to contain its source, but the last update happened in 2016.

    See http://perldoc.pl for a new site motivated by the same feelings you expressed in the parent.

    BTW, there's a way how to make links clickable on PerlMonks, e.g. [https://perldoc.perl.org/File/stat.htm]https://perldoc.perl.org/File/stat.htm.

    map{substr$_->[0],$_->[1]||0,1}[\*||{},3],[[]],[ref qr-1,-,-1],[{}],[sub{}^*ARGV,3]
      Many thanks for the link @perldoc.pl! At last, exactly what the doctor ordered, this should get more promotion really. I've been wondering about the same thing, almost since I fell in love with Perl not too long ago, then perldoc.perl looked the same as now. At the same version also, which I think was already behind. Wouldn't need a facelift, was rather thinking of a simple update. It appears abandoned and even though the manuals don't change that fast it still feels wrong as it's also linked on Perl.org, of course, and so about the first impression some people might get: an "official" doc repo with outdated content. It's how I got there. But then I was only looking for a painless option to have the docs on hand when traveling. Without googling every time. I do have a complete installation on my smartphone, even two, but it's no fun reading man pages in Android's Termux. Whereas perldoc.pl looks good on my phone too. Bookmarked.

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: perlmeditation [id://1229431]
Approved by Corion
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others drinking their drinks and smoking their pipes about the Monastery: (13)
As of 2019-10-22 13:39 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?
    Notices?