Hiya,

As someone who is trying to get into packaging in Fedora, I would really
really appreciate the docs being less dispersed:
- https://docs.fedoraproject.org/en-US/packaging-guidelines/
- https://fedoraproject.org/wiki/How_to_create_a_GNU_Hello_RPM_package
- https://rpm-packaging-guide.github.io/
- etc.

more up-to-date and more comprehensive. I used to work with FreeBSD a lot
before and there although packaging was a lot harder due to the clunky
reliance on Makefiles, the FreeBSD Porter's Handbook thoroughly covered
almost everything, from absolute basics to minute details. Many of the RPM
packaging guides are extremely basic and miss important macros like
%{qmake_qt5}
or changes like the obsolition of %{?_smp_mflags}. Heck, at one point I
even had to refer to some ancient guides (http://ftp.rpm.org/max-rpm/ and
http://wiki.rosalab.ru/en/index.php/Rpmlint_Errors), because the official
docs omit important nuances. In all honesty, there should ever be only *one*
document on packaging, possibly split into multiple pages for committing
convenience. Also, changes and updates to RPM spec design should be
simultaneously reflected in the official docs.

The Fedora Magazine articles are great to lower the barrier of entry, but
after that the prospective packager is lost in details which will
eventually come up in the review process and will have to be addressed on a
per-package basis.

As someone who just recently started out with packaging and has a fresh
view on the problem, I would be more than happy to help out with the docs
:).

Best,
Andy

On Wed, 27 May 2020 at 12:31, Miroslav Suchý <msu...@redhat.com> wrote:

> Dne 21. 05. 20 v 10:52 Ankur Sinha napsal(a):
> > Hi folks,
> >
> > The packaging team is generally quite stretched, and we frankly need
> > more people helping us out.
> >
> > The main issue with newcomers taking on packaging is that the learning
> > curve here is much more technical then a lot of other areas in Fedora.
> > So, while it is still expected that folks read the docs and learn things
> > themselves, perhaps we could be more active in helping them?
> >
> > We've had rpm packaging classroom sessions in the past. Are any folks
> > interested in restarting these? Maybe a different SIG could do a session
> > each month to help newcomers get started with packaging their tools?
> > Sponsors, what do you think?
>
> There is already:
>
> https://docs.pagure.org/copr.copr/user_documentation.html#how-can-i-package-software-as-rpm
> It already includes two recordings of such workshops.
>
> And I encourage everyone to particapate on
>   https://rpm-packaging-guide.github.io/
> You can contribute to this at:
>   https://github.com/redhat-developer/rpm-packaging-guide
>
>
> --
> Miroslav Suchy, RHCA
> Red Hat, Associate Manager ABRT/Copr, #brno, #fedora-buildsys
>
> _______________________________________________
> devel mailing list -- devel@lists.fedoraproject.org
> To unsubscribe send an email to devel-le...@lists.fedoraproject.org
> 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@lists.fedoraproject.org
>
_______________________________________________
devel mailing list -- devel@lists.fedoraproject.org
To unsubscribe send an email to devel-le...@lists.fedoraproject.org
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@lists.fedoraproject.org

Reply via email to