metacpan-web VS doc

In January 2018, I proposed a CPAN Butterfly Plan to convert Perl functionality to Raku as closely as possible to the original API. I stated this as a goal because Perl (as a programming language) is so much more than syntax alone. Ask anyone what Perl's unique selling point is, and they will most likely tell you it is CPAN.

MetaCPAN. There are a number of project in the Perl community. This is one of the most interesting ones. source code

Perl has numerous modules for practically everything. Try a search on https://metacpan.org for anything that takes your fancy.

I can point to the module library metacpan.org that has modules to do tons of different things -- I don't know what equivalent resouorce Python has.

A good place for this issue would be https://github.com/metacpan/metacpan-web

All language package index websites are a poor imitation of metacpan.org. Without a doubt it is the single best package website I have used for finding packages, reading docs, examples, version changes, source repo. Everybody should be shamelessly copying it.

While the indicates that this is a Windows-related thing, there are a number of packages on CPAN that are in the Win32 namespace, but also work on Linux. This one, it seems does not. It seems at least one of its dependencies, the Win32-API does not work on anything else besides Windows.

A Perl distribution is an archive of files that includes a Perl module. There are no official rules on what non-module files must be included in a distribution, but they often include (among other things) test scripts, a Makefile.PL, documentation, and the license. These distributions are commonly uploaded to CPAN, which is a place for Perl programmers to upload their Perl distributions for the purpose of sharing their code.

If there are modules being used, you can read their documentation using the perldoc command or looking online at https://metacpan.org

* list of list literals (1,2; 3,4) eqv ((1,2), (3,4));

to paraphrase Larry Walk “everyone wants the [semi] colon”

https://docs.raku.org/

amen to this … i recommend thinking about your problem in terms of effective data structures and then apply even a very simple DSL to handle access and transformations … fwiw the built in Grammars and Slang support in raku https://docs.raku.org are fantastic tools for this job.

When I was looking at the language, I didn't find the documentation "really poor". In fact I was impressed at how much of a one-stop-shop the official docs site was for both conceptual docs and API docs.

https://docs.raku.org/

The Raku Programming Language documentation already contains most (if not all) the documentation you need to deal with the issues you will confront in migrating Perl code to Raku. But, as documentation goes, the focus is on the factual differences. These blogs will try to go a little more in-depth about specific issues and provide a little more hands-on information based on my experience porting quite a lot of Perl code to Raku.

I will start working on the new version of Pod as a branch in https://github.com/raku/doc.

Well, performance has been improved by several orders of magnitude since the first release. So maybe it's time to look at https://raku.org again (or first have a look at its new documentation site https://docs.raku.org)

go to https://docs.raku.org/ and type "IO" into the search field. Behold the list that appears. Check out IO::Path or IO::Handle or whatever looks interesting. Maybe it's just me but I go "Ooh, look at all the things!".

Related: The Raku documentation does an excellent job explaining hashes/dictrionaries/associative arrays. If you've any issues, please submit a Github issue.

Raku has a lot of syntax. My first attempt at learning the language failed because I couldn't get past all the strange syntax I saw at https://docs.raku.org/. Sometimes I didn't know what the syntax was called, so I didn't know what to search for.

In the course of figuring this out, I realized that our docs also (slightly) misstate what \d means in a Regex, which led to this PR. So thanks for bringing all this up!