ocurrent / opam-repo-ci

An OCurrent pipeline for testing submissions to opam-repository
Apache License 2.0
20 stars 22 forks source link

Add a way to semi-automate support for first-time package authors #372

Open shonfeder opened 1 day ago

shonfeder commented 1 day ago

Integration should be about people, not just software. One of the bright silver linings of the opam way is that every package publication involves a personal interaction between the package author/maintainer and the opam repo maintainers.

While we need to move to automated publication of established, correct packages (see, e.g., https://github.com/ocaml/opam-repository/issues/26106) in order to avoid toil and improve our throughput, we have good reason to offer special support and acknowledgement of first-time publishers (e.g., https://github.com/ocaml/opam-repository/pull/26652#issuecomment-2389815358). This is an opportunity to ease their technical experience and their social connections within the ecosystem.

This issue is just at the "gathering ideas" stage, but ideas we may explore include:

The lowest hanging fruit is just automating a welcome message so that maintainers know they are interacting with a first-time publisher (akin to the notice we get in discourse for someone's first post).

shonfeder commented 1 day ago

If we can get a (probably rotating) group to opt in as a "welcome party", we could cultivate an amazing first experience for people who publish on opam. E.g., we the welcome party could do stuff like:

The ideal cohort for this kind of welcome party would be beginners and intermediate OCamlners probably: they have the most to gain from this kind of support, both in terms of technical know-how and social connections. But we would probably need to bootsrap such a tradition through participation of more experienced contributors.

samoht commented 1 day ago

That's a really great idea!

punchagan commented 22 hours ago

:+1: on this being a great idea!

  • Make PRs into the new publisher's project to help fix common issues that turn up during package publication.
  • Provide peer review and support generally for new package authors and OSS contributors.

This makes the whole contribution experience a whole lot more friendly and welcoming. A couple of years ago I tried contributing a package to melpa (An Emacs Package Archive) and was pleasantly surprised by some suggestions given by the maintainers, which improved the package itself a lot!