Pull requests are an important aspect of how Fedora packaging works,
and, crucially, the easiest way for new contributors to get started.
Document a way how they can be used.
Fixes#66
To make it simpler to link to the packaging tutorial, add a main page
for it. The content is very simplistic, at least for now. All the
actual content is in tutorial sections, and it does not seem worthwhile
to repeat any of it in the main page.
Old instructions failed at 'fedpkg commit' line.
Replaced with working sequence of 'git' commands.
There does not seem to be a way to use fedpkg with freely named
branches,
and even if there was,
using fedpkg as a git wrapper does not really make anything easier.
Also remove reference to wiki page about HTTPS-Commits.
The page seems to be seriously outdates
and does not contain useful information for anonymous fedpkg users.
Resolves#64
The packaging tutorial recently moved from Quick Docs to here,
but a link here was still pointing to the old location.
Naming Guidelines are just one part of the Packaging Guidelines,
and have been for a long time.
There is no point is linking to both separately.
Many pages contained instructions for installing packager tooling.
For most parts, the instructions were the same,
but each page did something a bit differently than others.
All of these separate instructions are merged to a single page here.
Each page just links to that one page.
Potential contributors often complain
that the joining process is too complicated.
Most probably the sponsorship process is the main cause for this,
because it does not have definite steps to follow.
Adding a brief note about the process right in the beginning,
so that it does not come as a surprise later.
Page Joining the Package Maintainers suggested
subscribing to the package-announce mailing list.
Due to its great volume,
this is not generally a good idea.
Replaced that suggestion with a suggestion
to adjust the Watch settings in the Package Sources.
Package-announce, as well as similar scm-commits list,
are mentioned as an alternative.
Finding a section where this information can be located
required some changes in document structure,
which as an additional improvement
also allows giving a bit more visibility
for the fact that a productive Package Maintainer
does not necessarily have to own a package.
Resolves#36
We sometimes get people introducing themselves on devel-announce and other lists. This makes it clear which list they should send the self-introduction to.
After Package Maintainer Docs were imported from the wiki
there have been some further wiki updates.
To avoid losing content when wiki pages are replaced
with links to the Package Maintainer Docs,
these updates are imported in this commit.
Some pages were already handled in a preceding commit.
This commit handles the reset.
The "Imported from:" comment is removed
from the top of the pages that are handled
since now that the migration is complete,
that information is not relevant any more.
When Package Maintainer Docs are published,
duplicate material in the Fedora Wiki should be removed
and replaced with links to the new docs.
In order to make this easy,
add a comment at the start od each page
linking to the original wiki page.
Restart the repository by
1. Starting to use Antora
2. Moving over some packaging related pages over from the wiki
3. Updating the pages where there are obvious problems