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

Documentation is to be overhauled

by hippo (Chancellor)
on May 14, 2021 at 14:30 UTC ( #11132595=perlnews: print w/replies, xml ) Need Help??

Google is funding an analysis of and action plan for the Perl documentation as part of the project to make Perl 7 more newcomer-friendly. This work is to begin imminently and should be completed by the end of the year.


🦛

Replies are listed 'Best First'.
Re: Documentation is to be overhauled
by 1nickt (Abbot) on May 15, 2021 at 12:47 UTC

    This seems to be fabulous news, not just for the documentation work, but because Google is investing in Perl!


    The way forward always starts with a minimal test.
Re: Documentation is to be overhauled
by thomas895 (Deacon) on May 16, 2021 at 02:42 UTC

    From the Project Proposal:

    The project's goals do not include:
    • Any changes made to the websites or other public resources that host, publish, or otherwise make available Perl's documentation.

    I'm especially happy to see this. I was afraid this was going to be just a "delete the man pages and make a JavaScript-heavy web docs" type of idea, as we see all too often in other spheres

    -Thomas
    "Excuse me for butting in, but I'm interrupt-driven..."

Log In?
Username:
Password:

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

How do I use this? | Other CB clients
Other Users?
Others surveying the Monastery: (6)
As of 2021-06-22 10:05 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?
    What does the "s" stand for in "perls"? (Whence perls)












    Results (102 votes). Check out past polls.

    Notices?