Commit graph

20 commits

Author SHA1 Message Date
52fb85df60 Add Pull Request Guide
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
2024-07-04 22:07:56 +03:00
7033af84d6 Replace Wiki links that already redirected to Fedora Docs
Redirects show unnecessary warnings in `check-links.sh` output, and
using the Wiki for anything documentation related should be avoided.
2024-07-04 21:39:42 +03:00
4c18097685 Add main page for packaging tutorial
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.
2024-06-09 22:51:16 +03:00
644ff8704c
Fix simple typos 2023-05-15 17:32:13 -04:00
a8613d3ea5 Use xref instead of linking to docs.fp.o
The recommended way of linking to other Fedora Docs pages
is to use Asciidoc xref: instead of urls, see:
https://docs.fedoraproject.org/en-US/fedora-docs/contributing-docs/asciidoc-markup/#external-antora-link

Convert all such urls to xrefs.
2023-01-03 23:00:30 +02:00
Jiri Hnidek
23d5a1dc17 Update modules/ROOT/pages/Joining_the_Package_Maintainers.adoc
Added note about uploading ssh key to all servers.
2022-08-23 10:05:07 +00:00
f6aa83acfe
feat: remove explicit toc
The UI bundle now includes a toc in the right hand sidebar, so there's
no need to have tocs explicitly at the start of documents.
2022-03-16 15:37:09 +00:00
Otto Urpelainen
4e5c5b43b1 Improve anonymous fedpkg usage instructions
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
2022-03-10 09:05:05 +00:00
Otto Urpelainen
f4b2a09a58 Improve some links in the Join page
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.
2022-02-11 23:50:59 +02:00
Otto Urpelainen
9ef3b5b958 Deduplicate tool installation instructions
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.
2022-02-11 23:28:03 +02:00
Otto Urpelainen
74645ee25e Use the majorosver attribute in Joining page
This makes it easier to make the docs look recent,
as they will not contain references to long obsolete releases.
2022-01-31 23:17:29 +02:00
Otto Urpelainen
4246dcf030 Mention sponsoring at start of Join preparations
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.
2021-11-25 12:37:41 +02:00
Otto Urpelainen
2b68e2399a Improve readability of Read Other Submissions 2021-11-13 10:19:47 +02:00
Otto Urpelainen
eb5fd8742c Update mailing list subscription recommendations
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
2021-11-13 10:14:00 +02:00
Otto Urpelainen
c53555b39d Fix links to obsolete wiki pages
Some links were still pointing to obsolete wiki pages
that have replacements in docs.fedoraproject.org.
2021-09-28 21:49:15 +03:00
Ben Cotton
1dc5b2ccde Make the introduction list explicit
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.
2021-09-16 19:10:25 +00:00
Otto Urpelainen
d0e1bca913 Import remaining wiki updates
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.
2021-09-15 09:07:06 +03:00
Otto Urpelainen
9f54ac3b07 Prefer [#some-ref] over [[some-ref]] 2021-08-22 14:01:27 +03:00
Otto Urpelainen
5b6d4b2db8 Add Imported from tags to pages from wiki
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.
2021-08-22 13:57:01 +03:00
Otto Urpelainen
bd40aeedab Wiki import
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
2021-07-07 21:55:43 +03:00