Commit graph

32 commits

Author SHA1 Message Date
James Antill
788b0cdc9e Merge #1311 Add an evidence for font package naming 2024-09-26 16:22:03 +00:00
d63dc74c1d Remove all mention of XEmacs
- Modernize the spec file templates
- Describe all current emacs variants
- Recommend building with emacs-nw
- Guard against %{_emacs_version} being undefined
- Update location of emacs RPM macro file
- Change British English spelling to American English spelling
- Add semantic line breaks
2024-05-13 15:37:26 -06:00
Akira TAGOH
fcdd45f96c Add an evidence for font package naming
There was some evidence how we should follow for the font package naming
but it was dropped by 20983f3643 and
the reference became a dead link since then.
This isn't good thing because we are missing the reason why fonts-rpm-macros
behave like that.  We still need an evidence in our policy.
2023-10-13 16:44:53 +09:00
34480a83b5 guidelines/Naming: Add a note for OBS Studio plugin packages
OBS Studio is now packaged in Fedora, and plugin packages are on
the way. This documents the naming convention for these packages.
2023-04-19 15:28:58 -04:00
aa17c26399 guidelines/Naming: Add information about NGINX module packages
It has been possible to package NGINX modules for a few cycles
now and a few packages exist in the distribution. This documents
the pattern being used there.
2023-04-19 15:23:57 -04:00
3397f78dc0 guidelines/Naming: Add note of naming convention for GStreamer plugins
This has been the generally accepted practice for quite a while now,
let's document it so people are aware.
2023-04-19 15:18:38 -04:00
Carl George
6c9d9c08da Remove duplicate tables of contents
The Fedora docs theme now defaults to placing a table of contents on the
right hand side, so we don't need to set these attributes.
2023-01-31 21:57:45 -06:00
Malcolm Inglis
661fa5108c Fix Naming Guidelines monospace for package names 2021-10-13 15:14:23 +00:00
Malcolm Inglis
d14bb4e72d Fix Naming Guidelines R modules examples header 2021-10-13 15:14:23 +00:00
Malcolm Inglis
051dfde6d9 Fix Naming Guidelines symbols formatting
Motivated by the "httpd, pam, and SDL" section having broken formatting
due to the `_` not being escaped. In fixing that, I took the opportunity
to normalize the formatting of other symbols on this page too.
2021-10-13 15:14:23 +00:00
48ccb8e1c3 Remove Eclipse plugin section from naming guidelines 2021-10-11 13:40:23 -05:00
c5e3949225 Manually merge PR1086.
Closes 1096.
2021-09-23 16:55:35 -05:00
Didik Supriadi
ca8ca562b8 Fix a link in Naming.adoc
It should direct to PHP naming scheme
2021-07-25 13:39:35 +00:00
Several members of Fedora Python SIG
f5723f9e0b Add new Python packaging guidelines 2021-07-20 10:48:30 +00:00
ea2e576f7f [Package Naming] Use admonition instead of paragraph
Should be more eye-catching while not distract the table
of contents.
2021-05-03 03:15:37 +02:00
72db63f004 [Package Naming] Minor fixes 2021-05-03 03:14:25 +02:00
366974773d [Package Naming] Fix various references 2021-05-03 03:06:01 +02:00
5c80e18913 [Package Naming] Fix bold formatting 2021-05-03 02:50:08 +02:00
786b5fe0cc suppress indentation warning 2020-04-19 16:01:11 +02:00
deca5f722c Capitalize some language names. 2019-06-21 10:11:16 -05:00
70e7ea5d7c Fix several typos. 2019-06-21 10:11:16 -05:00
Jason Tibbitts
154fba78a6 Add Lua naming guidelnes
Related #878
2019-04-18 11:03:32 -05:00
Jason Tibbitts
64fc03dbe0 Alphabetize sections and capitalize
The sections were in a sort of random order; some were alphabetical and
some weren't.  Sort them all except for the odd "httpd, pam and SDL"
section.

Also consistently capitalize section titles.
2019-04-18 10:21:11 -05:00
Jason Tibbitts
5bc9c11eda Strip pointless trailing whitespace 2019-04-18 10:15:21 -05:00
7c409ee304 Uses <<>> syntax for in-page references. 2019-03-23 09:50:47 +00:00
23aeef3b59 Update guidelines/modules/ROOT/pages/Naming.adoc
Fixes invalid hyper links.
2019-03-22 04:36:22 +00:00
c54853ab4b fix broken links
The linkchecker tool was used to identify broken links in the generated
documentation.  After running 'make && make serve' in one terminal,
linkchecker is run in another:

    linkchecker --check-extern --user-agent="curl/7.61.1" \
                --ignore-url="file:///antora/" \
                --ignore-url="https://crates.io" \
                --ignore-url="https://hosting-service/" \
                http://0.0.0.0:8000/packaging-guidelines/

One broken link remains: the Perl SIG "New Package SCM Request" link.
This has no direct replacement (in the context of adding an 'initial-cc'
to bug reports), as far as I can tell.  That text and link need to be
rewritten.  In context:

    New Perl packages should set the
    https://lists.fedoraproject.org/admin/lists/perl-devel.lists.fedoraproject.org/[Fedora
    Perl SIG mailing list] as a member of the initial-cc list for bugzilla.
    This can be done by adding the user `+perl-sig+` to the initial CC list
    when creating the link:Package_SCM_admin_requests#New_Packages[New Package
    SCM Request].

We ignore https://crates.io because it behaves badly with non-browser
tools (refer to https://github.com/rust-lang/crates.io/issues/788 for
details).

The --user-agent option is necessary to work around issues at sites like
drupal.org, which return a 403 when used with linkchecker's default
User-Agent header (LinkChecker/X.Y).
2019-03-07 17:03:24 +00:00
Jason Tibbitts
9ca537f5c1 Convert Naming guidelines to semantic linebreaks. 2019-01-09 13:49:27 -06:00
60ba24ee23 enable Tables of Contents on pages that want them
Merges: https://pagure.io/packaging-committee/pull-request/804
2018-10-05 17:45:13 +02:00
Igor Gnatenko
60f9e22189
trivial: drop Category: links
Signed-off-by: Igor Gnatenko <ignatenkobrain@fedoraproject.org>
2018-09-22 08:50:12 +02:00
Igor Gnatenko
1d0bff1b20
trivial: make all inline text literal
Signed-off-by: Igor Gnatenko <ignatenkobrain@fedoraproject.org>
2018-09-22 08:50:12 +02:00
Igor Gnatenko
8a2c101fb5
adapt to antora
Signed-off-by: Igor Gnatenko <ignatenkobrain@fedoraproject.org>
2018-09-22 08:50:12 +02:00
Renamed from Packaging:Naming.adoc (Browse further)