#75 Update multi package update instructions
Merged by oturpe. Opened by oturpe.
fedora-docs/ oturpe/package-maintainer-docs multi-build-update  into  main

Download 75.patch

Package Update Guide contained strange instructions
recommending using side tags only for Rawhide and early branched,
and buildroot overrides for late branched and stable.
Actually, side tags should be preferred in every case.
Merged the instructions together to new section "Multi Package Updates"
that prefers side tags in all cases.

Resolves #33

rebased onto 85b9f2810b6c2b122a3770c41434e2d727e2f62d

@churchyard I think you have asked for this more than once.
Please take a look.

This method was included in the previous version, but I am not sure.
Would it be simpler and safer to just say "use side tags",
even if there may be some cases where this method would suffice?

I think what you have here now is fine... someday we may retire buildroot overrides entirely and we can remove that then...

Technical: Could we keep the updating_inter_dependent_packages anchor somewhere in this document?

I would consider fedpkg --release {BRANCH} request-side-tag more familiar to packagers. WDYT?

That might be out of scope here. Ignore the comment.

I think the override section is as good as it gets. They exist and should only be used when side tags do not suffice. +1

Technical: Could we keep the updating_inter_dependent_packages anchor somewhere in this document?

Good point. Another AsciiDoc nut to crack.
Turns out this syntax allows multiple anchors for one section:

[#multiple_packages]
== [[updating_inter_dependent_packages]] Multi-package updates

rebased onto 7a9aab8da0fbd581fc1041187bd79274b699e13b

I would consider fedpkg --release {BRANCH} request-side-tag more familiar to packagers. WDYT?

That might be out of scope here. Ignore the comment.

I edited that section a bit regardless.
It now covers the case of creating a side tag for non-rawhide better,
and also lists that simplex syntax.

I did further minor formatting changes,
and added a short section about removing unused side tags.
I think this is ready for merge now.
I will self-merge if nobody else does that.
Maybe @kevin can do that, as he is in the committer group?

Pull-Request has been merged by oturpe

Self-merged.

Thank you \o/

Metadata