Commit graph

104 commits

Author SHA1 Message Date
adee435bf4
🔗 docs: Swap out remaining Pagure links (closes #285)
PR #287 updated most Pagure links to Forge, but left `fedora-badges` and
`minimization` as known exceptions because they were not yet migrated.
Both repos have since been migrated:

- fedora-badges → apps/badges-assets (issue numbers track 1:1)
- minimization → docs-archive/minimization (issue numbers track 1:1)

This commit updates the three remaining links for these repos. The other
five `pagure.io` references are intentionally left as-is:

- **3x CoC links**: Still the active reporting path on Pagure, pending a
  workflow decision by the CoC Committee.
- **1x fedora-diversity/issue/98**: Closed historical issue that
  predates the `dei/` migration, needs investigation.
- **1x initiatives.adoc**: Descriptive text about sun-setting Pagure.

Closes #285.

Ref: #285

Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
2026-07-09 14:08:24 -04:00
e827fbcecf Fix title hierarchy that was causing "Untitled" title in the tab (#289)
Reviewed-on: #289
2026-06-18 08:48:13 +00:00
1ce607e7a2 Update most Pagure links to Forge (#287)
Notable exceptions:
- CoC doesn't have any public Forge repos
- fedora-badges doesn't exist on Forge

Reviewed-on: #287
Reviewed-by: Petr Bokoč <pbokoc@noreply.forge.fedoraproject.org>
2026-05-21 16:46:53 +00:00
e56c24d1b6 Fix matrix link 2026-05-04 18:46:26 +02:00
3a8f9a7d1a Update Matrix links 2026-04-29 14:02:44 +02:00
963d79f529 Fix broken link to the Code of Conduct 2026-03-10 15:55:59 +01:00
cd9955a8dc
🎨 project(ROOT): Remove hanging whitespace on communications.adoc
This commits are terrible, nobody likes them, but nobody likes hanging
whitespace either. Who told you that you could hang out there, all extra
and hanging? You don't belong there, whitespace. Go find some other file
to haunt.

This will also make my future PR reviews easier because this will stop
coming up in this file.

Signed-off-by: Justin Wheeler <jwheel@redhat.com>
2026-03-04 18:26:07 -08:00
ff99714320
📝🐛 project(ROOT): Use xref for Legal docs link, use AsciiDoc
Some parts of the previous commit were written in Markdown. This commit
fixes the pending feedback and gets this merged, so the guidance can be
officially published, and this Pull Request can be merged before the
upcoming migration to Forgejo.

Signed-off-by: Justin Wheeler <jwheel@redhat.com>
2026-03-04 18:24:52 -08:00
5081d711aa add information on account removal 2026-03-05 01:48:37 +00:00
7392c529b5
📝 docs(project): Retire Fedora bootc, add Git Forge 2025 Initiatives
This commit does a bit of housekeeping, to drop the Fedora bootc
Initiative as a completed Initiative (thanks @jasonbrooks!) and replaces
it with the Git Forge 2025 Initiative (welcome @ryanlerch!).

Signed-off-by: Justin Wheeler <jwheel@redhat.com>
2025-10-27 15:16:30 +01:00
Gordon Messmer
eb05988cb0 Clean up additional FWIKI references. 2025-08-18 12:22:34 -07:00
d6211800db
📝 docs(project): Update Initiatives (closes Fedora-Council/tickets#485)
This commit updates the information we are currently publishing about
Fedora Community Initiatives that are in flight. Notably, the CommOps
and Mentored Projects Initiatives are completed, so they will no longer
be listed on this page.

Closes Fedora-Council/tickets#485.

ref: https://pagure.io/Fedora-Council/tickets/issue/485

Signed-off-by: Justin Wheeler <jwheel@redhat.com>
2025-06-10 15:56:17 +02:00
1268ed1ef8 remove irc/libera reference 2025-04-04 17:25:13 +00:00
7bb3cd6baf
📛✒️ s/Flory/Wheeler
This commit updates my last name throughout the Project and Council docs
pages. I am officially and legally "Wheeler" now and I have already
updated my FAS account information. So this is just making it more
official!

Signed-off-by: Justin W. Wheeler <jwf@redhat.com>
2025-04-02 10:25:19 -05:00
d1719d28cd
📝 docs(project): Reorder sections, clarify user focus in Upstream First
This commit refactors the "Upstream First: A Core Fedora Principle"
document to improve clarity and flow, and incorporates feedback from the
community.

Changes include:

- Move the "Fedora's Commitment to Upstream First" section to the top to
  emphasize the core principle and its rationale.
- Integrate the key points from the "The Benefits of Upstream First"
  section into the "Fedora's Commitment to Upstream First" section,
  removing redundancy and streamlining the document.
- Add a statement emphasizing Fedora's commitment to prioritizing user
  benefit, even if it means diverging from upstream decisions.
- Minor edits for improved readability and consistency.

Signed-off-by: Justin W. Wheeler <jwf@redhat.com>
2025-04-02 10:15:53 -05:00
e992119d2c
📝 docs(project): Voluntary nature, early testing, positive relations
This commit addresses a round of feedback by other community members in
building this common definition of what "Upstream First" means to the
Fedora community:

* Addressed @jnsamyak feedback by emphasizing the voluntary nature of
  the Upstream First philosophy and encouraged contributors to actively
  adopt it in their work by adding a call to action at the end.

* Addressed @dreua feedback by adding an example about early testing and
  bug reporting in the Python ecosystem to the "Examples in Action"
  section.

* Addressed @joseph feedback by including a sentence in the "Open
  Communication with Upstream" section to highlight the importance of
  positive and respectful relationships with upstream projects,
  extending Fedora's values to those interactions.

Signed-off-by: Justin W. Wheeler <jwf@redhat.com>
2025-02-22 18:56:05 -05:00
013a145f9e
📝 docs(project): Add context for nonfree blobs and bundled dependencies
This commit addresses feedback from @mattia about the Upstream First
principle and why we do this in Fedora. Changes summarized below:

* Added "Non-Free Blobs" to Downstream Reasons: Incorporated the point
  about patching out non-free or pre-built blobs as a reason for
  downstream patches in the "When Downstream Changes Happen" section.

* Added "Avoiding Bundled Dependencies" Example: Included an example in
  the "Examples in Action" section illustrating how Fedora avoids
  bundling dependencies to ensure consistency, security, and
  compatibility.

Signed-off-by: Justin W. Wheeler <jwf@redhat.com>
2025-02-18 11:31:30 -05:00
73112bf569
📝 docs(project): Add Upstream Comms section for Upstream First
This commit addresses feedback from @kevin in Matrix about how we engage
and work together with upstream communities. It emphasizes that while we
are not always going to agree with upstream's suggestions, we work hard
to maintain strong, healthy relationships with our upstreams, and Fedora
values the importance of working together in what we do as a community.

Signed-off-by: Justin W. Wheeler <jwf@redhat.com>
2025-02-17 16:02:22 -05:00
e7c8fa9b5f
📝♻️ docs(project): Incorporate edits to Upstream First doc
This commit incorporates a few additional changes to the original draft,
per discussion in the Pagure Pull Request comments:

* Added Section on Downstream Patches: Addressed @shaunm's excellent
  point about explaining the "second" part of "upstream first" by adding
  a new section "When Downstream Changes Happen." This section explains
  the legitimate reasons for downstream patches and emphasizes that they
  are not contradictions of the core principle.

* Clarified "Distinguishes Fedora": Removed potentially exclusive
  phrasing as per @smilner's suggestion. The focus is now on the
  practice of Upstream First, not comparisons.

* Emphasized Pragmatic Benefits: Incorporated @blc's point about the
  practical engineering advantages of upstream first, specifically the
  reduction of maintenance burden. This adds another layer of
  justification for the principle.

* Added License Clarifications Example: This example summarizes
  @mattdm's point about the importance of upstreaming license-related
  fixes. It highlights how Fedora contributors actively engage with
  upstream projects to address licensing issues, ensuring compliance and
  broader inclusion in the open source ecosystem.

* Minor Edits: Minor edits for clarity and flow.

ref: https://pagure.io/Fedora-Council/council-docs/pull-request/244

Signed-off-by: Justin W. Wheeler <jwf@redhat.com>
2025-02-17 14:31:30 -05:00
a40f527a6f
📝🆕 docs(project): Initial commit, "Upstream First" (closes #84)
This commit adds a new page that offers an explanation and overview of
Fedora's place in the Fedora ecosystem. This is inspired by a request
that @ankursinha asked to the Council in August 2020, and recent events
with the Flatpak/OBS situation.

The goal of creating this page is an attempt at making an implicit part
of our community ethos into something explicit. If we do not write it
down and make sure we are clear about what we believe, how can we expect
that the next generation will be able to steward the project in
accordance with our values and beliefs in the betterment of Free
Software? This explanation may not be perfect, but it is a first start,
and it is placed prominently in our official project documentation.

Closes Fedora-Council/council-docs#84.

ref: https://pagure.io/Fedora-Council/council-docs/issue/84

Signed-off-by: Justin W. Wheeler <jwf@redhat.com>
2025-02-17 14:31:19 -05:00
d0414bda32
📝🚚 docs(code-of-conduct): Initial commit
This commit migrates all content related to the Fedora Code of Conduct
into a new Antora module. This segments it off from the rest of the
Fedora Project docs and also sets up in the future to have reviewer
groups on Forgejo that are automatically tagged for review on specific
Antora modules.

It also provides improved discoverability of the Fedora CoC source
material. I used Antora page aliases to handle redirects from the
previous URL paths.

ref: https://pagure.io/Fedora-Council/council-docs/pull-request/242

Signed-off-by: Justin W. Wheeler <jwf@redhat.com>
2025-02-14 23:25:15 -05:00
9c01c9c8d8
📝🔥 docs(council/policy): Remove outdated CoC Response Policy
This commit removes a policy that was not updated along with the new
Fedora Code of Conduct in 2021. This policy documents an incorrect and
outdated process from 2018 that is no longer observed. It is misleading
and communicates wrong information. Therefore, it should just be removed
instead of going through the Council Policy Change Policy.

The removed page now redirects to the current Fedora Code of Conduct
page for anyone who bookmarked the previous URL.

Signed-off-by: Justin W. Wheeler <jwf@redhat.com>
2025-02-14 21:40:17 -05:00
a10ea7503e Update project/modules/ROOT/pages/brand.adoc
Fix minor typo under Secondary Logos / Logo Templates: "If you require a logo for you application" -> "If you require a logo for your application"
2024-12-25 02:04:47 +00:00
c24b48a325 adding branding page 2024-12-17 12:35:21 +00:00
Matthew Miller
e2279608a2 Update project/modules/ROOT/pages/brand.adoc 2024-12-05 21:22:31 +00:00
5a5c13a334 add brand book to brand page 2024-11-12 12:43:40 -05:00
Matthew Miller
af123f91b8 Merge #229 Add banner to Join page 2024-10-22 14:29:25 +00:00
Skye Chappelle
6e40cdb246 Change some old links to prevent possible future link rot.
The ARM link here should probably be removed as well, since it redirects to fp.o (same as getfedora does) but that's a job for a separate commit at the very least and maybe a separate PR.

In addition, the Fedora Leadership wiki page that's linked here has a warning about being possibly deleted due to lack of maintenance, though I'm not sure what to do to help with that personally.
2024-09-26 17:35:10 +00:00
14d33c5808
📝 docs(project): Update CoC Committee membership
This commit updates the public list of Code of Conduct Committee members
in the official documentation.

ref: https://pagure.io/CoC/issue/345

CC: @mattdm @riecatnor @dcantrell @jonatoni @dvolavkova

Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
2024-09-26 11:34:07 -04:00
2a1f69d644
📝 docs(project): Add CommOps and bootc Initiatives
This commit adds two ongoing Community Initiatives into the Fedora
Project docs:

1. Adds Community Operations 2.0 Initiative, co-led by me and @rwright
2. Adds Fedora bootc Initiative, led by @jasonbrooks
3. Uses more partials/attributes for links

Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
2024-08-05 16:47:51 -04:00
678f4e875d initiatives: add Mentored Projects initiative details 2024-08-05 20:40:33 +00:00
45d7578946 Add banner to Join page
The artwork is taken from
https://pagure.io/fedora-join/WelcomeToFedora/blob/main/f/Artwork/Welcome-to-Fedora-banner-Feb2022.png
2024-07-14 18:40:21 +02:00
40c085fc9c Update project/modules/ROOT/pages/index.adoc
Fixed comma and grammatical error
2024-02-16 16:51:46 +00:00
459c8e2574 Fix misspellings 2023-12-28 17:43:54 -03:00
0ae323cb0c
docs(project): Expand Executive Sponsors in Initiatives (closes #189)
This commit expands the language about Executive Sponsors in Community
Initiatives by adding a section that clarifies how the Executive Sponsor
is selected, what the expectations are between the Lead and the Sponsor,
and other requirements for the Initiative (e.g. an Executive Sponsor
must be attached to an Initiative in order for it to proceed).

Additionally, I made minor changes to other parts of the document, such
as using more `xref` links to other pages in the Fedora documentation
site, adding a lead-in at the top of the Initiatives page, and other
English usage/mechanics edits.

These changes were worked on collaboratively between myself, @amoloney,
and @mattdm.

Closes #189.

ref: https://pagure.io/Fedora-Council/council-docs/issue/189

Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
2023-10-20 18:10:25 -04:00
Ben Cotton
1f55f3485b the Web & Apps revamp initiative is complete 2023-05-03 16:04:46 -04:00
Ben Cotton
1ed64d207a Add CoC Committee docs
As approved in https://pagure.io/Fedora-Council/tickets/issue/442
2023-04-03 09:22:06 -04:00
5a41f5ae29
Changed order of chat vs email in join.adoc 2023-03-21 13:44:05 +00:00
4e51a2a042
Merge branch 'issue101-convert-help-wiki' of ssh://pagure.io/forks/karl0sfandang0/Fedora-Council/council-docs into issue101-convert-help-wiki 2023-03-21 13:42:28 +00:00
f12e709a40
Changes based on comments in PR #186 2023-03-21 13:27:31 +00:00
1a14eae9ce
Issue #101. Re-arranged side menu; Updated help and join pages and added communications page 2023-03-21 12:47:36 +00:00
Ben Cotton
a0da4f40d7 Improve the wording
Thanks @mattdm
2023-03-20 09:23:28 -04:00
Ben Cotton
61fc7cddc4 Add a minimal sponsorship page
Mostly so we can redirect an outdated wiki page
2023-03-15 16:24:10 -04:00
93e4b9c620 Issue #101. Re-arranged side menu; Updated help and join pages and added communications page 2023-03-09 22:46:50 +00:00
Ben Cotton
99658c6e23 Fix the redirect for the objectives URL
Fixes #184
2023-03-07 14:27:01 -05:00
Ben Cotton
18e8c7b8b4 Add the license of the Code of Conduct to the document
Approved by the Fedora Council:
https://meetbot.fedoraproject.org/fedora-meeting-1/2023-02-28/council.2023-02-28-21.05.log.html#l-12

Signed-off-by: Ben Cotton <bcotton@fedoraproject.org>
2023-03-03 14:19:34 +00:00
a32810d33a
removed extraneous aliases ref from beginning of initiatives.adoc 2023-03-02 21:21:32 +00:00
988104f5d8
Fixing for comments on lines 14 and 26 in PR#180 2023-02-27 21:08:22 +00:00
79b5108567
Amendments as per comments on PR#180 2023-02-24 08:05:18 +00:00
1ce6cea9e2
Updates to Initiatives page.
Removal of failing ref to attributes.adoc file.
Change side menu to "Initiatives"
Change reference "Objectives" to "Community Initiatives" on "Get Involved" page

Signed-off-by: Karl Stevens <karlosfandango64@gmail.com>
2023-02-23 13:43:58 +00:00