Beefy Boxes and Bandwidth Generously Provided by pair Networks
P is for Practical
 
PerlMonks  

Re^2: Bookmarklet to show deeplinks in perldoc.perl.org

by jdporter (Chancellor)
on Jun 17, 2019 at 14:08 UTC ( #11101470=note: print w/replies, xml ) Need Help??


in reply to Re: Bookmarklet to show deeplinks in perldoc.perl.org
in thread Bookmarklet to show deeplinks in perldoc.perl.org

A year ago, we had some discussion about switching to perldoc.pl. It was left unresolved. I want to know what the arguments are on both sides. It was claimed that perldoc.perl.org was moribund, yet I don't see any evidence that that's true. If I can be convinced that perldoc.pl is a better choice for our (PM) needs, I'll switch it.

I reckon we are the only monastery ever to have a dungeon stuffed with 16,000 zombies.
  • Comment on Re^2: Bookmarklet to show deeplinks in perldoc.perl.org

Replies are listed 'Best First'.
Re^3: Bookmarklet to show deeplinks in perldoc.perl.org
by choroba (Archbishop) on Jun 17, 2019 at 14:36 UTC
    See for example Reddit or GitHub for some discussions. It's probably too early to judge the new beta version of perldoc.org. perldoc.pl has been, on the other hand, mature for some time already.

    map{substr$_->[0],$_->[1]||0,1}[\*||{},3],[[]],[ref qr-1,-,-1],[{}],[sub{}^*ARGV,3]
Re^3: Bookmarklet to show deeplinks in perldoc.perl.org
by LanX (Sage) on Jun 17, 2019 at 15:07 UTC
    > If I can be convinced that perldoc.pl is a better choice for our (PM) needs, I'll switch it.

    some thoughts:

    • If switching means that old doc-links will refer to perldoc.pl I'm not sure if URL paths are consistent.
    • We used to have a [metacpan:://...] alternative to [cpan://..] . ( [docpl://..] might be an option but I'm not too convinced.)
    • you may add a user setting such that users like Choroba can choose jumping perldoc.pl for each ... link

    Personally I prefer direct auto-linking of bare http-URLs. My wikisyntax does this.

    > It was claimed that perldoc.perl.org was moribund,

    I only had minor issues with perldoc.perl.org. (like the need to scroll up after a deeplink, because the first lines where covered by the navbar.)

    And like already mentioned in the OP are possible deep-targets not easily accessible.

    What I have trouble to understand is why they suddenly replaced it with a worse beta-version of something else.

    Cheers Rolf
    (addicted to the Perl Programming Language :)
    Wikisyntax for the Monastery FootballPerl is like chess, only without the dice

      If switching means that old doc-links will refer to perldoc.pl I'm not sure if URL paths are consistent.

      OTOH, not switching would have the same problem, as perldoc.perl.org is messing with their own stuff.

      But I'm not sure this is in fact a problem. [doc://open] has no URL paths.

      direct auto-linking of bare http-URLs.

      I have no idea what that means. Can you clarify? TIA.

      I reckon we are the only monastery ever to have a dungeon stuffed with 16,000 zombies.
      > why they suddenly replaced it

      Because the old one was out of date (it hadn't been updated for more than a year, so it didn't show the latest Perl version's documentation, it was stuck at 5.26 IIRC) and there was no one to maintain it in its current state.

      Another question is, why they suddenly replaced it when a replacement had already existed at perldoc.pl. I don't know the answer.

      map{substr$_->[0],$_->[1]||0,1}[\*||{},3],[[]],[ref qr-1,-,-1],[{}],[sub{}^*ARGV,3]
        Am I mislead or did the old version allow to be downloaded with an embedded JS search engine?

        Cheers Rolf
        (addicted to the Perl Programming Language :)
        Wikisyntax for the Monastery FootballPerl is like chess, only without the dice

      Any URL paths to actual documentation pages should still work. Index pages are an invention of perldoc.perl.org and won't, though I could be convinced to add forwarding for them. -Grinnz
Re^3: Bookmarklet to show deeplinks in perldoc.perl.org
by marto (Cardinal) on Jun 17, 2019 at 14:11 UTC
      There's no longer an obvious search function? I have to go digging through, and think about whether my issue is a function, syntax, or special variable? I prefer the other.

      -QM
      --
      Quantum Mechanics: The dreams stuff is made of

        Not that I've seen so far, to be fair this is still a beta release. The UI does not render well on my (now) fairly low resolution netbook. The issue of core modules not being listed has been resolved.

Re^3: Bookmarklet to show deeplinks in perldoc.perl.org
by Anonymous Monk on Jun 18, 2019 at 19:47 UTC
    At the time, the last evidence of maintenance was adding Perl 5.26 at the end of 2017, and there was no evidence of anyone fixing bugs since 2011 (several of which have yet to be fixed so far, and many new ones now added, but we'll see what the next iteration brings). The revamp work was entirely unknown aside from vague promises of "an update" until last week; so until then I would have agreed with "moribund", and indeed that was the motivation for perldoc.pl, but that is clearly no longer apt.

      Yes; and before the recent revamp, there wasn't even any indication or link to whoever was responsible for maintaining the site. Upon that, yo invoco la vacacaca.

      I reckon we are the only monastery ever to have a dungeon stuffed with 16,000 zombies.

Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Node Status?
node history
Node Type: note [id://11101470]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others avoiding work at the Monastery: (4)
As of 2022-05-28 02:21 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?
    Do you prefer to work remotely?



    Results (98 votes). Check out past polls.

    Notices?