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@xxxxxx> > Sent: Monday, April 22, 2024 3:29 PM > To: Development discussions related to Fedora > <devel@xxxxxxxxxxxxxxxxxxxxxxx> > 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@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe send an > email to devel-leave@xxxxxxxxxxxxxxxxxxxxxxx > 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=
<<attachment: smime.p7s>>
-- _______________________________________________ devel mailing list -- devel@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe send an email to devel-leave@xxxxxxxxxxxxxxxxxxxxxxx Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/ List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/devel@xxxxxxxxxxxxxxxxxxxxxxx Do not reply to spam, report it: https://pagure.io/fedora-infrastructure/new_issue
