#41 Update mailing list subscription recommendations
Merged by oturpe. Opened by oturpe.
fedora-docs/ oturpe/package-maintainer-docs share-mailing-list-list  into  main

Download 41.patch

Page Joining the Package Maintainers suggested
subscribing to the package-announce mailing list.
Due to its great volume,
this is not generally a good idea.
Replaced that suggestion with a suggestion
to adjust the Watch settings in the Package Sources.
Package-announce, as well as similar scm-commits list,
are mentioned as an alternative.

Finding a section where this information can be located
required some changes in document structure,
which as an additional improvement
also allows giving a bit more visibility
for the fact that a productive Package Maintainer
does not necessarily have to own a package.

rebased onto 79b20bb44fa68ede557806917005e0ad8802db48

rebased onto 6763887e146144640a1eca0720866985fa003cf5

Should we also suggest the packages app? (the search function on src.fp.o is not very nice)

https://packages.fedoraproject.org/ ?

This is about co-maintaining? Should we put this at the end near the "adding a new package" bit as one of the two paths to being a maintainer?

Is the package-review list worth mentioning as a high traffic list where are package review related e-mails are sent?

package-review@lists.fedoraproject.org

Looks good in general, a few comments but nothing major :)

Metadata Update from @ankursinha:
- Request assigned

Should we also suggest the packages app? (the search function on src.fp.o is not very nice)
https://packages.fedoraproject.org/ ?

Good idea, I will add that.

This is about co-maintaining? Should we put this at the end near the "adding a new package" bit as one of the two paths to being a maintainer?

Yes, either co-maintaining or even more informal contribution
in form of bug reports, pull requests and taking part in discussion.
The main idea is that there is much more to packaging
than just having your own package.
Ideally, making changes related to that should be done separately,
not mixed in a pull request about mailing lists.
But I was not happy at all about having scm-commits and package-announce
in the list of "important mailing lists",
as if you could usefully subscribe to those without having automatic processing.
The volume is simply too great.
But on the devel list, an opinion was expressed
that these lists should be mentioned somehow,
so I did some restructuring to find a place to mention them
in a sensible context.

You are right that the fallout from this,
i.e. having co-maintainer related things in one place
and new packages at another
is also strange.
I will see what can be done.

Is the package-review list worth mentioning as a high traffic list where are package review related e-mails are sent?
package-review@lists.fedoraproject.org

Well, since scm-commits and package-announce are mentioned,
it would be weird not to mention this.
On the other hand,
I think the list of important mailing lists should be such
that the newcomer can simply subscribe to all of them.
Making them think which lists are useful and which not is more mental burden,
and there is enough of that in the Joining phase already.

I think a good place to mention this list could be section Read Other Submissions.
Actually, it probably is trying to recommend it,
but somehow list name and a link to its Hyperkitty page is missing.
Maybe due to an error in the wiki import,
Pandoc helpfully replaces some Wiki markup it does not understand with empty strings,
causing issues that look exactly like that.
What if I just insert the list there?

rebased onto eb5fd8742c409db6b3ff5e83b8ae5de5a6862f29

Pull-Request has been merged by oturpe

I did the changes as discussed.
I think there is no need for another round of review here,
so I went ahead and merged the updated version.
If there are any concerns about the updated version,
we can always push fixes later.

Thank you for the review!

Metadata