A review from a complete newbie ...
1. The link points to a pull request. Where is the actual tutorial?
2. The page refers to Pagure, Antora, ... I wonder if they're necessary for
packaging.
As a newbie, I would like an example that looks like:
1. Push the main branch to github.
2. Do these steps.
n. Push the result to Fedora.
-----Original Message-----
From: Otto Liljalaakso <otto.liljalaakso(a)iki.fi>
Sent: Monday, April 22, 2024 3:29 PM
To: Development discussions related to Fedora
<devel(a)lists.fedoraproject.org>
Subject: [EXTERNAL] Simpler first tutorial package for Package Maintainer
Docs
Hello everybody,
I wrote a pull request for Package Maintainer Docs about adding a simpler
tutorial package than GNU Hello [1]. Since it is a larger change and I have
not
received any reviews yet, I would like to announce this work here, in hope
of
getting some feedback, before just merging the change. Since I have already
described the work in the pull request description, I will just copy it here
below. Feel free to respond on the list or in pull request comments.
[1]:
https://urldefense.proofpoint.com/v2/url?u=https-
3A__pagure.io_fedora-2Ddocs_package-2Dmaintainer-2Ddocs_pull-
2Drequest_153&d=DwIGaQ&c=BSDicqBQBDjDI9RkVyTcHQ&r=H5QohD_RgG
RTOmpJ5rew0X87YNwM_iH7SF9XZijdV0o&m=ZVYh2Pnj1mqVP5ceO87VGJei
n8OQF7fgyLfPmsvXyFeH6tl2Kb4aaz2DxgI9q2Qq&s=9f59NzD15enLv7LSAINyq
u2CgUH6sNGK-Cg0UcV6s0c&e=
> Add simpler Banner package to packaging tutorial > > Packaging
tutorial's
approach of packaging GNU Hello has suffered from > certain complexities in
GNU Hello package. The package is quite old and > uses some tooling from
the GNU project that are not very widely used > any more, such as Texinfo.
Also, the package is old and thus suffers > from e.g. having a file that is
not
UTF-8 encoded. To avoid immediately > exposing tutorial readers to these
quirks, make GNU Hello part 2 of the > tutorial and add a simpler package,
Banner, as part 1. This way the > reader can reach a complete specfile,
compliant with Fedora guidelines, > quicker, and still get a feeling for
resolving packaging quirks in the > second part.
>
> In the future, basing the first tutorial on real packages should >
probably
be switched to hosting dedicated "test project", which avoid > any quirks
and can be packaged to Fedora requirements using only > Fedora's set of
RPM macros. Such package should also avoid GNU > Autotools and be based
on CMake or Meson, which are simpler to > understand and more
widespread today.
--
_______________________________________________
devel mailing list -- devel(a)lists.fedoraproject.org To unsubscribe send an
email to devel-leave(a)lists.fedoraproject.org
Fedora Code of Conduct:
https://urldefense.proofpoint.com/v2/url?u=https-
3A__docs.fedoraproject.org_en-2DUS_project_code-2Dof-
2Dconduct_&d=DwIGaQ&c=BSDicqBQBDjDI9RkVyTcHQ&r=H5QohD_RgGRTO
mpJ5rew0X87YNwM_iH7SF9XZijdV0o&m=ZVYh2Pnj1mqVP5ceO87VGJein8O
QF7fgyLfPmsvXyFeH6tl2Kb4aaz2DxgI9q2Qq&s=tFCi6cDadUhB1bZclnUCohaFJ
rgTkvR5NnS-SHMxdHc&e=
List Guidelines:
https://urldefense.proofpoint.com/v2/url?u=https-
3A__fedoraproject.org_wiki_Mailing-5Flist-
5Fguidelines&d=DwIGaQ&c=BSDicqBQBDjDI9RkVyTcHQ&r=H5QohD_RgGRT
OmpJ5rew0X87YNwM_iH7SF9XZijdV0o&m=ZVYh2Pnj1mqVP5ceO87VGJein8
OQF7fgyLfPmsvXyFeH6tl2Kb4aaz2DxgI9q2Qq&s=LceMIV98ssz8tBj3dPpYKoU
Q_6FtslD2n8OplfoD2Gs&e=
List Archives:
https://urldefense.proofpoint.com/v2/url?u=https-
3A__lists.fedoraproject.org_archives_list_devel-
40lists.fedoraproject.org&d=DwIGaQ&c=BSDicqBQBDjDI9RkVyTcHQ&r=H5Q
ohD_RgGRTOmpJ5rew0X87YNwM_iH7SF9XZijdV0o&m=ZVYh2Pnj1mqVP5ce
O87VGJein8OQF7fgyLfPmsvXyFeH6tl2Kb4aaz2DxgI9q2Qq&s=tUj2hgkHU9Ysg
n51Pm4QTFm10zvnF42eY0r-1BdLZUc&e=
Do not reply to spam, report it:
https://urldefense.proofpoint.com/v2/url?u=https-3A__pagure.io_fedora-
2Dinfrastructure_new-
5Fissue&d=DwIGaQ&c=BSDicqBQBDjDI9RkVyTcHQ&r=H5QohD_RgGRTOmpJ
5rew0X87YNwM_iH7SF9XZijdV0o&m=ZVYh2Pnj1mqVP5ceO87VGJein8OQF7f
gyLfPmsvXyFeH6tl2Kb4aaz2DxgI9q2Qq&s=H_CLa7ff1mo0zci91H2hQCFU8Q6jj
c64N-4A_lQR_NU&e=