From 17e45e81af1f13f596439ab295128c14356419ca Mon Sep 17 00:00:00 2001 From: Otto Urpelainen Date: Jul 08 2021 20:02:37 +0000 Subject: Index page --- diff --git a/modules/ROOT/pages/index.adoc b/modules/ROOT/pages/index.adoc index b890d2a..a8972cf 100644 --- a/modules/ROOT/pages/index.adoc +++ b/modules/ROOT/pages/index.adoc @@ -1,9 +1,92 @@ -= The Pizza Project -John Doe; Jane Doe -:page-authors: {author}, {author_2} += Fedora Package Maintainers +:toc: -The Pizza Project is a useful project with a very bad name — it helps you with writing some new documentation for Fedora. +Fedora Packages are maintained collectively +by a community of both Red Hat members and volunteers. -In fact, this is just a source template for a new piece of the Fedora Docs. +[useful_links_for_package_maintainers] +== Useful links for Package Maintainers -image::pizza.png[Pizza] +[get_involved] +=== Get Involved + +* xref:Joining_the_Package_Maintainers.adoc[Joining the Package Maintainers] + +* xref:Package_Review_Process.adoc[Package Review Process] +— describes the formal review process (for both contributors and reviewers) + +* https://fedoraproject.org/wiki/Category:Packaging_SIGs[Packaging SIGs] +— Informal groups of packagers working on specific areas of the distribution + +* https://fedoraproject.org/wiki/EPEL[EPEL] +— Rebuild of Fedora packages for RHEL or compatible derivatives + +[packaging_guidelines] +=== Packaging Guidelines + +The https://fedoraproject.org/wiki/Packaging_Committee[Packaging Committee] handles the rules +and https://docs.fedoraproject.org/en-US/packaging-guidelines[Packaging Guidelines] +for writing SPEC files for software in Fedora. + +[introduction_to_packaging] +=== Introduction to packaging + +* http://rpm.org/max-rpm-snapshot/[Maximum RPM Book] +— most detailed, but slightly obsolete. + +* http://docs.fedoraproject.org/en-US/Fedora_Draft_Documentation/0.1/html/RPM_Guide/index.html[RPM Guide] +— an in-depth guide to RPM. + +[procedures_policies_and_guides] +=== Procedures, Policies and Guides + +* https://fedoraproject.org/wiki/Using_Mock_to_test_package_builds[Using Mock to test package builds] + +* https://bodhi.fedoraproject.org/docs/user/man_pages/bodhi.html[Using the Bodhi CLI tool] + +* https://fedoraproject.org/wiki/Milestone_freezes[Milestone freezes] +— how the Fedora Beta and Final freezes affect packagers + +* https://fedoraproject.org/wiki/Fedora_Release_Life_Cycle[Fedora Release Life Cycle] +— information on the Fedora development process, +particularly various freeze dates and such + +[resources_for_fedora_package_collection_contributors] +=== Resources for Fedora Package Collection contributors + +* https://fedoraproject.org/wiki/Category:SIGs?rd=SIGs[SIGs] — Fedora Special Interest Groups + +* https://bugzilla.redhat.com/bugzilla/describecomponents.cgi?product=Fedora[Fedora package components in bugzilla] + +* https://koji.fedoraproject.org/koji/[koji — Fedora Package Build System] + +* https://bodhi.fedoraproject.org/[bodhi — Fedora Package Update System] + +* https://calendar.fedoraproject.org/vacation/[Vacation Calendar] +—Add a vacation note if you are going to be unavailable for a few days. + +* https://fedoraproject.org/wiki/Test_Machine_Resources_For_Package_Maintainers[Test Machines] +— Contributed servers for test, mock build, compile or debug packages before submitting to koji + +[important_mailing_lists] +=== Important Mailing Lists + +* https://lists.fedoraproject.org/admin/lists/devel-announce@lists.fedoraproject.org/[devel-announce] is a low traffic, announcements only list +where important development information is posted. + +* https://lists.fedoraproject.org/admin/lists/devel@lists.fedoraproject.org/[devel] is a high traffic mailing list +where discussions about the development of Fedora are held. + +* https://lists.fedoraproject.org/admin/lists/package-announce@lists.fedoraproject.org/[package-announce] is a very high traffic mailing list +where notifications are given for all the commits +in any package in the Fedora repository. +Note that the Fedora package database sends commit mails +for packages you (co-)maintain. + +* https://lists.fedoraproject.org/admin/lists/packaging@lists.fedoraproject.org/[packaging] is the mailing list of the https://fedoraproject.org/wiki/Packaging_Committee[Fedora Packaging Committee], +who determine the official packaging guidelines for Fedora projects. + +[fesco] +=== Fedora Engineering Steering Committee (FESCo) + +Fedora technical management is organized by the https://docs.fedoraproject.org/en-US/fesco/[Fedora Engineering Steering Committee (FESCo)].