Beefy Boxes and Bandwidth Generously Provided by pair Networks
No such thing as a small change

Request for Feedback: Perl Documentation Site

by Anonymous Monk
on Oct 27, 2019 at 23:55 UTC ( [id://11108026] : perlnews . print w/replies, xml ) Need Help??

The official Perl documentation site at was recently overhauled. Independently, I put together a reimagined documentation site that would be hosted at In the interest of providing a documentation site that best serves the needs of the Perl community, we need your feedback. Please give both sites a try, in-depth if you want, or just how you would most commonly use the site. What do you like about the design or the functionality of each site? What is missing or can be improved? Any feedback regarding what you want from the Perl documentation site is helpful and appreciated. Please leave comments here or in the linked posts by Monday Nov 18th. comments

Reddit comments

Replies are listed 'Best First'.
Re: Request for Feedback: Perl Documentation Site
by haukex (Archbishop) on Oct 28, 2019 at 08:23 UTC

    I prefer the design of a little more over the redesigned look. One thing I miss from both sites is the quick navigation menu on the left - unfortunately, my suggestion to bring it back to was rejected without explanation. If had such a menu, then it would become my preferred documentation site. Update: Actually, is only my "preferred" site because PerlMonks [doc://] links to that, and when my brain is on autopilot I still type in the address bar. Plus I remember reading somewhere that .pl domains are blocked in some countries - so I would welcome somewhere beneath the domain :-)

Re: Request for Feedback: Perl Documentation Site
by Eily (Monsignor) on Oct 28, 2019 at 13:54 UTC
Re: Request for Feedback: Perl Documentation Site
by swmcd (Initiate) on Nov 11, 2019 at 19:48 UTC

    First, I very much dislike the new design
    - It's full of eye-candy and wasted screen space.
    - It has a deep navigation hierarchy: you have to click and click and click to get where you're going. suits me much better
    - It's text-only.
    - It's big and flat. I can get the whole thing at once and scroll to find what I need.

    Couple of things on
    - The code boxes are low-contrast and hard to read on my screen. Not sure why this is. The font is very lightweight; maybe needs to be heavier.
    - The code boxes render in courier. Courier was designed for typewriters. For better readability, consider using a modern fixed-width font that was designed for screens. (Or just specify "fixed" and let the browser choose.)
    - I need the row of index letters at the top of the perlfunc page that jump to the functions that start with that letter. I know they aren't in the POD, but scrolling through a page that big is awkward.

Re: Request for Feedback: Perl Documentation Site
by duelafn (Parson) on Oct 28, 2019 at 10:55 UTC

    The landing page of is friendlier.

    On both sites, the dropdown menus are non-functional to users with JavaScript disabled.

    Good Day,

Re: Request for Feedback: Perl Documentation Site
by Anonymous Monk on Dec 22, 2019 at 06:05 UTC
    What is missing or can be improved?

    Why would someone decide to downgrade the official perldocs at by eliminating the PDF? It makes no sense. They should adding features, not taking them away.

      I actually had no idea that existed (apparently everyone else has also forgotten). Is this simply a PDF version of each page? It would be a reasonably doable feature to add to -Grinnz

        FWIW I still prefer to the official online docs, it works well on my small screen netbook.