From Fedora Project Wiki
No edit summary |
(Redirect Package Maintainer wiki links to docs.fp.o) |
||
(31 intermediate revisions by 6 users not shown) | |||
Line 1: | Line 1: | ||
{{CompactHeader|fonts}} | {{CompactHeader|fonts-sig}} | ||
''Putting it all together.'' | ''Putting it all together.'' | ||
Line 5: | Line 5: | ||
{| | {{Admon/note | Who are they? | | ||
|+ | ''Requester'' and ''Packager'' can be the same person. ''Reviewer'' must be different from the ''Packager''.}} | ||
{|class="wikimedia sortable" style="t1" rowclass="th" border="1" | |||
|+ A font package lifecycle | |||
|- | |- | ||
! Phase | ! Phase | ||
! # | |||
! Who | ! Who | ||
! Actions | ! Actions | ||
! Requirements | ! Requirements | ||
|- | |- valign="top" | ||
| [[:Category:Font_wishlist| | | {{Anchor|1}}[[:Category:Font_wishlist|Conception]] | ||
| [[#1|1]] | |||
| Requester | | Requester | ||
| | | | ||
Line 22: | Line 28: | ||
{{Admon/caution | Don't stop there | | {{Admon/caution | Don't stop there | | ||
This is a simplistic summary, '''do''' read our [[Legal_considerations_for_fonts| legal page]] before proposing new fonts.}} | This is a simplistic summary, '''do''' read our [[Legal_considerations_for_fonts| legal page]] before proposing new fonts.}} | ||
* fills a packaging request in the wiki using the current [[Font_description_template|template]] | * fills a [[:Category:Font wishlist|packaging request]] in the wiki using the current [[Font_description_template|template]] | ||
** a complete and accurate request will increase packaging and adoption potential | ** a complete and accurate request will increase packaging and adoption potential | ||
* notifies the SIG [[Fonts_SIG_mailing_lists | mailing list]] of the new packaging request (optional but recommended) | * notifies the SIG [[Fonts_SIG_mailing_lists | mailing list]] of the new packaging request (optional but recommended) | ||
Line 28: | Line 34: | ||
* a [https://admin.fedoraproject.org/accounts/user/new Fedora account], to edit the wiki ([[Infrastructure/AccountSystem|help]]), | * a [https://admin.fedoraproject.org/accounts/user/new Fedora account], to edit the wiki ([[Infrastructure/AccountSystem|help]]), | ||
* subscription to the [[Fonts_SIG_mailing_lists | main SIG list]], to send the request notification. | * subscription to the [[Fonts_SIG_mailing_lists | main SIG list]], to send the request notification. | ||
|- | |- valign="top" | ||
| rowspan=" | | rowspan="4" | {{Anchor|2}}[[:Category:In-progress fonts|Gestation]] | ||
| {{Anchor|2.a}}[[#2.a|2.a]] | |||
| Packager | | Packager | ||
| | | | ||
* picks up a packaging request in the [[:Category:Font wishlist|wishlist]], | * picks up a packaging request in the [[:Category:Font wishlist|wishlist]], | ||
* corrects and completes the information the requester provided | * corrects and completes the information the requester provided | ||
** using the | ** using the ''Packager'' notes in the [[Font_description_template|template]] for guidance | ||
* packages the fonts: | * packages the fonts: | ||
** following our official [[:Category:Fonts_packaging| font packaging policies]], | ** following our official [[:Category:Fonts_packaging| font packaging policies]], | ||
* uploads the | ** using our fonts spec templates ([[Simple fonts spec template|1]],[[Fonts spec template for multiple_fonts|2]]), | ||
# dnf install fontpackages-devel | |||
* self-checks the result: | |||
** builds the package in [[Projects/Mock|Mock]] or (if he's already a packager) in a [[Koji]] scratch build | |||
** checks the resulting packages with [[Common_Rpmlint_issues|rpmlint]] | |||
# dnf install rpmlint | |||
$ rpmlint package1.rpm … packageN.rpm | |||
** checks the resulting packages with repo-font-audit: | |||
# dnf install fontpackages-tools createrepo | |||
$ mkdir /tmp/testrepo | |||
$ mv package1.rpm … packageN.rpm /tmp/testrepo | |||
$ createrepo /tmp/testrepo | |||
$ repo-font-audit testrepo file:///tmp/testrepo | |||
* uploads the fixed packages somewhere | |||
** for example on his [http://fedorapeople.org/ fedorapeople] space, | ** for example on his [http://fedorapeople.org/ fedorapeople] space, | ||
* requests a review | * requests a review | ||
** fills a ticked in [https://bugzilla.redhat.com/bugzilla/enter_bug.cgi?product=Fedora&format= | ** fills a ticked in [https://bugzilla.redhat.com/bugzilla/enter_bug.cgi?product=Fedora&format=fedora-review bugzilla], CC-ing the [[Fonts_SIG_mailing_lists | bugs list]], | ||
** adds the review request reference to the original packaging request in the wiki, | ** adds the review request reference to the original packaging request in the wiki, | ||
** changes the packaging request category to [[:Category:In-progress fonts]]. | ** changes the packaging request category to [[:Category:In-progress fonts]]. | ||
Line 47: | Line 66: | ||
| | | | ||
* the full [[Joining_the_Fonts_SIG|joining the fonts SIG]] list, | * the full [[Joining_the_Fonts_SIG|joining the fonts SIG]] list, | ||
* if the packager is not a '' | * if the packager is not a ''packager'' member yet, the way his membership request will be acted on depends on the quality of the new package he proposes. | ||
{{Admon/tip | Font packages are normal packages | | {{Admon/tip | Font packages are normal packages | | ||
Most packaging steps are detailed on the general [[PackageMaintainers/Join|new fedora packager]] page.}} | Most packaging steps are detailed on the general [[PackageMaintainers/Join|new fedora packager]] page.}} | ||
|- | |- valign="top" | ||
| {{Anchor|2.b}}[[#2.b|2.b]] | |||
| Reviewer | | Reviewer | ||
| | | | ||
* [[Package_Review_Process | * makes sure the steps outlined in previous phases have been completed, [[#1|1]] included | ||
* | * [https://docs.fedoraproject.org/en-US/package-maintainers/Package_Review_Process/ reviews] the package | ||
* ask the requester fix eventual problems | |||
| | | | ||
* membership of the [https://admin.fedoraproject.org/accounts/group/view/fedorabugs fedorabugs] group. | |||
* good knowledge of [[:Category:Fonts_packaging| font packaging policies]], | * good knowledge of [[:Category:Fonts_packaging| font packaging policies]], | ||
* general Fedora [[ | * general Fedora [https://docs.fedoraproject.org/en-US/package-maintainers/Package_Review_Process/#_reviewer reviewer] requirements. | ||
|- | |- valign="top" | ||
| rowspan="2" | Birth | | {{Anchor|2.c}}[[#2.c|2.c]] | ||
| Packager | |||
| colspan="2" | | |||
* acts on reviewer requests | |||
|- valign="top" | |||
| {{Anchor|2.d}}[[#2.d|2.d]] | |||
| Reviewer | |||
| colspan="2" | | |||
* checks the fixes | |||
* approves the package | |||
|- valign="top" | |||
| rowspan="2" | {{Anchor|3}}Birth | |||
| {{Anchor|3.a}}[[#3.a|3.a]] | |||
| Packager | | Packager | ||
| colspan="2" | | | colspan="2" | | ||
* [[PackageMaintainers/Join# | * requests a [[Package SCM admin requests|VCS root]] for his package, declaring the [[pkgdbu:fonts-sig|fonts-sig]] user in the default CC list. | ||
* [[PackageMaintainers/Join#Check_out_the_module|publishes]] his package in the fedora-devel branch, then in other branches (stable release, EPEL branch, etc) | |||
* completes the distribution [[PackageMaintainers/CompsXml#Fonts | comps files]] | * completes the distribution [[PackageMaintainers/CompsXml#Fonts | comps files]] | ||
* adds the koji and | * adds the koji and pkgdb references to the original wiki packaging request | ||
* changes its category to [[:Category:Packaged fonts]] | * changes its category to [[:Category:Packaged fonts]] | ||
* notifies the SIG mailing list of the new package (optional but recommended) | * notifies the SIG mailing list of the new package (optional but recommended) | ||
|- | * notifies the font upstream its font has been packaged in Fedora (optional but recommended) | ||
|- valign="top" | |||
| {{Anchor|3.b}}[[#3.b|3.b]] | |||
| Requester | | Requester | ||
| colspan="2" | | | colspan="2" | | ||
* thanks the packager publicly. Small things count too. | * thanks the packager publicly. Small things count too. | ||
|- valign="top" | |||
|- | | rowspan="2" | {{Anchor|4}}[[:Category:Packaged fonts|Life]] | ||
| rowspan="2" | [[:Category:Packaged fonts|Life]] | | {{Anchor|4.a}}[[#4.a|4.a]] | ||
| Packager | | Packager | ||
| | | | ||
Line 87: | Line 123: | ||
{{Admon/caution | Don't leave now | | {{Admon/caution | Don't leave now | | ||
Please avoid fire and forget packaging.}} | Please avoid fire and forget packaging.}} | ||
|- | |- valign="top" | ||
| {{Anchor|4.b}}[[#4.b|4.b]] | |||
| Users | | Users | ||
| | | | ||
Line 95: | Line 132: | ||
{{Admon/caution | Bugzilla is required | | {{Admon/caution | Bugzilla is required | | ||
Packagers are not psychic, they don't monitor the whole web for problems, if you want them to address yours, please use our bugzilla.}} | Packagers are not psychic, they don't monitor the whole web for problems, if you want them to address yours, please use our bugzilla.}} | ||
|- | |- valign="top" | ||
| [[:Rejected and retired fonts|Death]] | | {{Anchor|5}}[[:Rejected and retired fonts|Death]] | ||
| [[#5|5]] | |||
| Fedora QA | | Fedora QA | ||
| colspan="2" | A change in Fedora policies or a problem missed earlier may cause a font package to be retired. | | colspan="2" | A change in Fedora policies or a problem missed earlier may cause a font package to be retired. | ||
|} | |} | ||
{{:Fonts_SIG_signature}} [[Category:Fonts | {{:Fonts_SIG_signature}} [[Category:Fonts packaging|Lifecycle, font packages]] |
Latest revision as of 11:11, 9 October 2021
Putting it all together.
The following is a quick summary to help newcomers undertand the Fonts SIG workflow.
Phase | # | Who | Actions | Requirements |
---|---|---|---|---|
Conception | 1 | Requester |
|
|
Gestation | 2.a | Packager |
# dnf install fontpackages-devel
# dnf install rpmlint $ rpmlint package1.rpm … packageN.rpm
# dnf install fontpackages-tools createrepo $ mkdir /tmp/testrepo $ mv package1.rpm … packageN.rpm /tmp/testrepo $ createrepo /tmp/testrepo $ repo-font-audit testrepo file:///tmp/testrepo
|
|
2.b | Reviewer |
| ||
2.c | Packager |
| ||
2.d | Reviewer |
| ||
Birth | 3.a | Packager |
| |
3.b | Requester |
| ||
Life | 4.a | Packager |
|
|
4.b | Users |
|
| |
Death | 5 | Fedora QA | A change in Fedora policies or a problem missed earlier may cause a font package to be retired. |