DEV Community

Cover image for 3 original Perl CPAN social concepts
Tib
Tib

Posted on • Edited on

3 original Perl CPAN social concepts

(Picture from Eren Li)

CPAN Lieutenants

Man army
(Picture from Alex Andrews)

I often mentally represent modules "per namespace" (I explained it here) like in a tree where we have a node "JSON" that contains all JSON related (JSON:PP, JSON:XS, etc...).

I know it's partially wrong, there's no such "order" and for instance Cpanel::JSON::XS is out of this hierarchy but still well a JSON thing. But most of the time, this mental model works.

If we care about the quality of the Perl ecosystem, we should try to find a solution to fight the CPAN inertia.

Indeed, what happen when a module is broken and maintainer is inactive/unresponsive?

Some important modules can be considered a bit a "common good" (is it wrong to think like this?) but we need also to respect the ownership and copyright.

So here is the concept of CPAN Lieutenants.

For some very specific cases (e.g. a module does not install at all), I think we should be able to "force apply" a patch to a module.
Boundaries should be clear:

  1. Purpose is to fix a broken module
  2. Fix is relatively simple (to review), blocker is about releasing it

In practice, it would mean to let few trusted members to manage a dedicated sub-tree of CPAN namespaces. And in extreme case, after some formal review, discussion and notifications, these people would be able to push a fix to CPAN (= publish a new release).

It would be a bit like these people, thanks to their trust and expertise, have implicit co-maintainer rights (CO-MAINT in CPAN jargon) on a topic (e.g. "Alien" modules, or "XML").

It won't imply these "lieutenants" to maintain these modules neither the ceremonial of asking (and eventually being refused) co-maintainer permissions. And don't hear what I did not say: I do not criticize PAUSE operating model for that.

The name is inspired from Linux kernel development with "lieutenants" that have responsibility on sub parts of the kernel.

Also we need to respect authors and their rights. It's a matter of finding the right balance so everybody wins. That's why we should be careful with boundaries and rules (e.g. a minimum number of lieutenants approvals), the same way PAUSE admins are careful with module ownership.

If it proves to be incompatible with license, we could consider a layer of patches, inspired by what do several Linux distributions (see for instance Locally applied patches: section under Debian/Ubuntu perl -V).

It proved to work (for inertia and licensing) but I would prefer to avoid this, first because it's generally considered good practice "to push patch upstream" when possible, also because it would add complexity and "yet another layer of patches":

  • CPAN release contains base delivery
  • GitHub locally applied patches (merged commits in GitHub that never reached CPAN)
  • CPAN locally applied patches ⚠️
  • OS Distribution locally applied patches

But on the other hand, the CPAN local patch layer approach has advantage of managing the storage of patch (since inertia very likely also concerns code forge...)

I don’t know the exact solution, but I think there’s something to do 😄

Actually, a recent discussion on perl development mailing list ("p5p") has highlighted the same need and discussed some close proposals. I swear I did not copied! 😀 But it decided me to post this!

edit 1: a CPAN module security vulnerability is also a valid reason to want this and I see that CPANSec folks have similar concern, see CPAN Security Patch Tooling

edit 2: A Social Contract about Artistic Control - perl core statement (applies to modules added to perl core distribution)

edit 3: DistroPrefs - CPAN.pm patching facility

CPAN Mentors

Helping blind

(Picture from Thirdman)

I think the barrier of entry of Perl is high but with a compatible mindset, once someone get in, Perl (and CPAN) produces often long time involved members.

These days, there's no so much new entrants to the CPAN.

We should optimize for retention (and unity).

The idea of CPAN Mentors is to offer help to newcomers, once they pass the entry door, something that we can monitor from perl modules mailing list

Let’s say after 3 weeks, if a new CPAN AUTHOR has not published any module, someone can drop a little mail:

Hello new CPAN AUTHOR,

I noticed you recently registered to PAUSE/CPAN, congratulation for this.
I also noticed that you did not publish any module, yet.
I don't know your level of expertise,
maybe you would benefit from some guidance?
I'm reaching you to kindly offer my help :) 
Feel free to ask me questions or we can maybe even accommodate some pairing via a call.

Regards.

Tib
Enter fullscreen mode Exit fullscreen mode

I think the number of new monthly CPAN registrations would permit it, and reinforce the community feeling that always been a strength of Perl.

CPAN Guards

Guard
(Picture from PhotoMix Company)

This concept joins actually a bit the CPAN Lieutenants concept.

The idea is to watch (and contribute to) a limited set of critical modules (depended by several modules or in Perl jargon: those high in the CPAN river) and help keeping them in good quality and portable.

This is actually not a new concept (forgive me the "original" in title), some people (CPANTesters and perl core developers) are already on it (see for instance BBC and CPAN River 5000).

So it's more about formalizing this under a fancy name.

CPAN Guards concept fits well the Perl folks that are more contributors than maintainers and prefer to jump often from modules to modules.

At some point it's also related to the Perl Phalanx initiative (more focused on tests)

Some reading and watching

Top comments (0)