From Fedora Project Wiki

(Link to meeting process)
(Hello Carl and Neal, bye Mat)
(35 intermediate revisions by 13 users not shown)
Line 1: Line 1:
= Fedora Packaging Committee =
<div style="float: right; margin-left: 0.5em;" class="tochidden">__TOC__</div>
 
The Fedora Packaging Committee determines the packaging guidelines for Fedora projects.  It also approves exemptions the various guidelines where required, as well as exemptions to the package review process.
 
 
{{Anchor|Purpose}}
== Purpose ==
The Fedora Packaging Committee determines the packaging guidelines for Fedora projects.


The FPC is an independent subcommittee of the [[Development/SteeringCommittee | Fedora Steering Committee (FESCo)]].
The FPC is an independent subcommittee of the [[Development/SteeringCommittee | Fedora Steering Committee (FESCo)]].
{{admon/note||The FPC will no longer require FESCo ratification of approved drafts/changes, however, any FPC member who feels an approved draft/change would benefit from explicit FESCo review and ratification may request it.}}


== Meetings and Discussions ==
== Meetings and Discussions ==
 
The Fedora Packaging Committee currently meets every Thursday at 17:00 UTC (16:00 UTC during US daylight saving time), in {{fpchat|#fedora-meeting-1}} on the freenode.net.
{{Anchor|Meetings}}
You can also find the meeting in the [https://apps.fedoraproject.org/calendar/packaging/ Fedora Calendar].
=== Meetings ===
The Fedora Packaging Committee currently meets every Thursday at 16:00 UTC, in {{fpchat|#fedora-meeting-1}} on the freenode.net .


For the meeting chair: process to run the meeting: https://fedoraproject.org/wiki/Packaging_Committee_Meeting_Process
For the meeting chair: process to run the meeting: https://fedoraproject.org/wiki/Packaging_Committee_Meeting_Process
{{Anchor|Minutes}}
==== Minutes ====
Meeting minutes are kept at [[Packaging:Minutes]].
{{Anchor|MailingList}}


=== Discussions ===
== Minutes ==
Discussion and decisions can also take place in the {{fplist|packaging}} mailing list. The mailing list is open to the public. To subscribe or view the archives, go to http://lists.fedoraproject.org/pipermail/packaging/.
Meeting minutes are kept at [https://meetbot.fedoraproject.org/sresults/?group_id=fpc&type=team fpc meetbot archive] (pre 2010-06: [[Packaging:Minutes]]).


{{Anchor|Members}}
== Discussions ==
Discussion and decisions can also take place in the {{fplist|packaging}} mailing list. The mailing list is open to the public.


== Members ==
== Members ==


* James Antill
* [[User:james|James Antill]] (geppetto)
* Tom Callaway (chair)
* [[User:Limb|Gwyn Ciesla]] (limburgher)
* Jon Ciesla
* [[User:laxathom|Xavier Lamien]] (laxathom/SmootherFr0gZ)
* Remi Collet
* [[User:tibbs|Jason Tibbitts]] (tibbs)
* Ralf Corsepius
* [[User:ignatenkobrain|Igor Gnatenko]] (ignatenkobrain)
* Toshio Kuratomi
* [[User:decathorpe|Fabio Valentini]] (decathorpe)
* Xavier Lamien
* [[User:Churchyard|Miro Hrončok]] (churchyard/mhroncok)
* Dominik Mierzejewski
* [[User:carlwgeorge|Carl George]] (carlwgeorge)
* Jason Tibbitts
* [[User:ngompa|Neal Gompa]] (Conan_Kudo, Pharaoh_Atem, Son_Goku... see the link)


{{Anchor|Agenda}}
== Agenda ==
The issues the committee is set to discuss are available in {{pagure|packaging-committee|pagure}}.  An agenda is generally mailed to the devel mailing list a day before the meeting.


== Agenda ==
== Bringing Issues to the Committee ==
The issues the committee is set to discuss are available in the [https://fedorahosted.org/fpc/report/3 fpc trac instance]
While you may be able to catch one of the committee members on IRC (generally in {{fpchat|#fedora-devel}}) or via discussion on the {{fplist|packaging}} mailing list, it is generally better for you to file a ticket. You can do so in our {{pagure|packaging-committee|pagure instance}}.


The old wiki page for tracking Guidelines for discussion and approval is here: [[Packaging/GuidelinesTodo]] but is no longer usedIt's mentioned here in case someone wants to take over work on one of the old proposals.
When filing tickets for any reason, please be as explicit as possible.  Provide more information than you think you might needIf asking about a specific piece of software, provide the URL instead of making the committee search.  Instead of just linking to a mailing list thread, provide a brief summary.  Everyone is busy, and complete and reasoned questions or submissions  will always fare better.


{{Anchor|GuidelineChangeProcedure}}
== Guideline Change Procedure ==
== Guideline Change Procedure ==
How a Packaging Draft becomes a Fedora Packaging Guideline, in six easy steps!
How a Packaging Draft becomes a Fedora Packaging Guideline, in six easy steps!


=== Step One: Draft Guidelines ===
=== Step One: Draft Guidelines ===
All Fedora Packaging Guidelines changes start out as Draft documents. Any Fedora contributor may propose new or amended Packaging Guidelines. To create a new Draft, add a new page on the wiki with the [[:Category:Packaging_guidelines_drafts|Packaging guidelines drafts]]. Once you're happy with the Draft, open a trac ticket on https://fedorahosted.org/fpc/ with a link to the draft. Draft authors are highly encouraged to announce the draft on the {{fplist|packaging}} mailing list.
All Fedora Packaging Guidelines changes start out as Draft documents. Any Fedora contributor may propose new or amended Packaging Guidelines. To create a new Draft, simply fork the {{pagure|packaging-committee}} git repository and make your proposed changes. Once you're happy with your draft, simply open a pull request (again to {{pagure|packaging-committee}} and  open an issue for the committee to use to discuss your draft.
 
Draft authors are also encouraged to announce the draft on the {{fplist|packaging}} mailing list.


=== Step Two: Packaging Committee Review ===
=== Step Two: Packaging Committee Review ===
The Packaging Committee will consider items on the [https://fedorahosted.org/fpc/report/3 fpc trac instance]  in its weekly meetings and on the mailing list. The meetings and mailing list are open to the public, and Fedora contributors are invited and encouraged to participate (especially if you are a Draft author).
The Packaging Committee will consider items on the [https://pagure.io/packaging-committee/issues?status=Open&tags=meeting fpc pagure instance]  in its weekly meetings and on the mailing list. The meetings and mailing list are open to the public, and Fedora contributors are invited and encouraged to participate (especially if you are a Draft author).


=== Step Three: Packaging Committee Vote ===
=== Step Three: Packaging Committee Vote ===
The Packaging Committee votes on Drafts. A majority quorum is required for a Draft to be ratified by the FPC. Currently, five yes votes are required for Draft approval. Approved drafts are listed in the Action Items section of the [[Packaging/GuidelinesTodo | GuidelinesTodo table]]  and marked "ratify".
The Packaging Committee votes on Drafts. A majority quorum is required for a Draft to be ratified by the FPC. Currently, five yes votes are required for Draft approval.


=== Step Four: FESCo Ratification (optional) ===
=== Step Four: FESCo Ratification (optional) ===
Line 65: Line 54:


=== Step Five: Writeup ===
=== Step Five: Writeup ===
Once a draft is approved, the Draft text is added to the Fedora Packaging Guidelines. The Draft wiki page may be moved to a new location in the <code>Packaging:</code> namespace or the information may be merged with existing Guideline pages and the draft page moved into archives.  The fpc trac ticket is closed with information about where the new Guideline lives.
Once a Draft is approved, the PR is merged.  The pagure ticket is closed with information about where the new Guideline lives.


=== Step Six: Announcement ===
=== Step Six: Announcement ===
As the final step, the new Packaging Guidelines (or changes to the existing Guidelines) are announced on the fedora-maintainers and {{fplist|devel}} mailing lists.
As the final step, the new Packaging Guidelines (or changes to the existing Guidelines) are announced on the fedora-maintainers and {{fplist|devel}} mailing lists.


==== Ticket updates ====
=== Ticket updates ===
In the interests of keeping the process moving for all contributors, please supply information requested by FPC members in your trac ticket in a timely manner.  If outstanding information requested in a trac ticket is not provided within two weeks, the ticket may be closed due to inactivity.
In the interests of keeping the process moving for all contributors, please supply information requested by FPC members in your pagure ticket in a timely manner.  If outstanding information requested in a pagure ticket is not provided within two weeks, the ticket may be closed due to inactivity.
 
== Bootstrapping Exception Procedure ==
If you need an exception to the "No pre-built binaries" guideline as indicated [[Packaging:Guidelines#Exceptions|here]] then please file a ticket in the FPC [https://pagure.io/packaging-committee/new_issue pagure]. Use "Bootstrap Exception" as the component and explain the nature of the software and its build process.  If you expect that you will need to bootstrap your package periodically, please indicate that.  FPC will generally grant a blanket exception for software which warrants it.
 
== Review Process Exemption Procedure ==
The FPC can grant exceptions to the normal package review process.  This may happen, for instance, if a large number of similar packages are being submitted at once or if a package is being updated to a new major version while the old version is being kept in the distribution with a different name.
 
Just file a ticket [https://pagure.io/packaging-committee/new_issue here], set the component to "Review Process Exception" and explain (with detail) why you're requesting the exemption and the committee will consider it in the next meeting.


[[Category:Packaging committee]]
[[Category:Packaging committee]]

Revision as of 16:56, 27 August 2020

The Fedora Packaging Committee determines the packaging guidelines for Fedora projects. It also approves exemptions the various guidelines where required, as well as exemptions to the package review process.

The FPC is an independent subcommittee of the Fedora Steering Committee (FESCo).

Meetings and Discussions

The Fedora Packaging Committee currently meets every Thursday at 17:00 UTC (16:00 UTC during US daylight saving time), in #fedora-meeting-1[?] on the freenode.net. You can also find the meeting in the Fedora Calendar.

For the meeting chair: process to run the meeting: https://fedoraproject.org/wiki/Packaging_Committee_Meeting_Process

Minutes

Meeting minutes are kept at fpc meetbot archive (pre 2010-06: Packaging:Minutes).

Discussions

Discussion and decisions can also take place in the packaging mailing list. The mailing list is open to the public.

Members

Agenda

The issues the committee is set to discuss are available in pagure. An agenda is generally mailed to the devel mailing list a day before the meeting.

Bringing Issues to the Committee

While you may be able to catch one of the committee members on IRC (generally in #fedora-devel[?]) or via discussion on the packaging mailing list, it is generally better for you to file a ticket. You can do so in our pagure instance.

When filing tickets for any reason, please be as explicit as possible. Provide more information than you think you might need. If asking about a specific piece of software, provide the URL instead of making the committee search. Instead of just linking to a mailing list thread, provide a brief summary. Everyone is busy, and complete and reasoned questions or submissions will always fare better.

Guideline Change Procedure

How a Packaging Draft becomes a Fedora Packaging Guideline, in six easy steps!

Step One: Draft Guidelines

All Fedora Packaging Guidelines changes start out as Draft documents. Any Fedora contributor may propose new or amended Packaging Guidelines. To create a new Draft, simply fork the packaging-committee git repository and make your proposed changes. Once you're happy with your draft, simply open a pull request (again to packaging-committee and open an issue for the committee to use to discuss your draft.

Draft authors are also encouraged to announce the draft on the packaging mailing list.

Step Two: Packaging Committee Review

The Packaging Committee will consider items on the fpc pagure instance in its weekly meetings and on the mailing list. The meetings and mailing list are open to the public, and Fedora contributors are invited and encouraged to participate (especially if you are a Draft author).

Step Three: Packaging Committee Vote

The Packaging Committee votes on Drafts. A majority quorum is required for a Draft to be ratified by the FPC. Currently, five yes votes are required for Draft approval.

Step Four: FESCo Ratification (optional)

FPC approved drafts normally go into effect immediately after a positive vote. However, provision is made for any FPC member to request explicit FESCo review of the changes after the vote is taken. This allows things that are controversial to be explicitly reviewed by a second set of people before being pushed live. In this case, FESCo needs to review the decision and can either approve it or request changes be made before the draft goes live.

Step Five: Writeup

Once a Draft is approved, the PR is merged. The pagure ticket is closed with information about where the new Guideline lives.

Step Six: Announcement

As the final step, the new Packaging Guidelines (or changes to the existing Guidelines) are announced on the fedora-maintainers and devel mailing lists.

Ticket updates

In the interests of keeping the process moving for all contributors, please supply information requested by FPC members in your pagure ticket in a timely manner. If outstanding information requested in a pagure ticket is not provided within two weeks, the ticket may be closed due to inactivity.

Bootstrapping Exception Procedure

If you need an exception to the "No pre-built binaries" guideline as indicated here then please file a ticket in the FPC pagure. Use "Bootstrap Exception" as the component and explain the nature of the software and its build process. If you expect that you will need to bootstrap your package periodically, please indicate that. FPC will generally grant a blanket exception for software which warrants it.

Review Process Exemption Procedure

The FPC can grant exceptions to the normal package review process. This may happen, for instance, if a large number of similar packages are being submitted at once or if a package is being updated to a new major version while the old version is being kept in the distribution with a different name.

Just file a ticket here, set the component to "Review Process Exception" and explain (with detail) why you're requesting the exemption and the committee will consider it in the next meeting.