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>
On 7 May 2026, @dcantrell tendered his resignation on the Fedora Council
private list. This commit processes the resignation in Code of Conduct
Committee documentation by noting the end of Dave's term as a past
member of the Committee.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
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>
This commit completely drops all of the content in `/engineering/` and
`/mindshare/` modules, because we are publishing them twice:
> https://gitlab.com/fedora/docs/docs-website/pages
This repository is where the docs.fp.o/engineering/ and
docs.fp.o/mindshare/ pages are actually getting generated from. The
source content in this repository appears to be duplicative. In the
interest of greater simplicity, we should remove things which are no
longer being used.
@pbokoc can verify whether the removal of this content will cause any
issues or breakages in the Fedora Docs publishing pipeline.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
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>
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>
This commit represents a notable change to the Fedora Code of Conduct,
including new language that describes our stance against retaliation and
defining protections for reporters and participants, and addressing the
issue of false reports.
The work in making this update began in September 2024 by Marie Nordin
(@riecatnor) who first raised this as an issue and identifying an
industry trend towards including language about retaliation in a Code
of Conduct. A proposal was made and went through several rounds of
revision. The revision represented in this commit was signed off by Red
Hat Legal (Richard Fontana) in January 2026.
Upon merging to the `main` branch, the Fedora Code of Conduct v2.1 comes
into effect and will be used as guiding reference for future tickets by
the Fedora Code of Conduct Committee.
CC, CoC Committee: @jspaleta@jonatoni@dcantrell@ankursinha@chris
CC, Council: @bookwar@churchyard@t0xic0der@amoloney@ryanlerch@pboy@pbokoc@nimbinatus
Fixes CoC#345.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
Performs a technical writing pass on `clarifying-statements.adoc` to
improve information hierarchy and scanability.
**Note on Scope**: These changes are strictly editorial and structural.
They do not materially alter the interpretation, substance, or
enforcement standards of the previously agreed-upon text. As this
refactor preserves the original intent while optimizing for
documentation standards, it is implemented as a unilateral maintenance
update.
**Detailed Changes**:
* **Structure**: Converts dense prose regarding event requirements into
a bulleted list to clearly delineate standards for "Digital Presence,"
"Event Prominence," "In-Person Reporting," and "Physical Signage".
* **Navigation**: Adds AsciiDoc anchors (`[[visibility]]`,
`[[adapting-contributor]]`) to support deep linking.
* **Clarification**: Renames the "Awareness" section to "Visibility and
Awareness" to better reflect the content.
* **Flow**: Streamlines the introduction to better position the file as
a supplementary, living document.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit makes the identity of a Fedora Code of Conduct more explicit
and clear, different from just "any" Code of Conduct. This will be
important for versioning of future changes to the Fedora Code of Conduct
document, to give the document a more firm identity and tracked changes.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit makes several minor changes to the Fedora Code of Conduct
document behind-the-scenes. The changes are as described as follows:
- Description: Adds a SEO-friendly description for the page, summarizing
the page and its contents. This will appear when linked online, e.g.
on social media websites or chat rooms.
- Authors: Add original authors, co-authors, and communities of
reference involved in the drafting of the Fedora CoC.
- Specifically version the current draft by Marie Nordin as v2.0, last
updated in May 2021. This will be important, as we will start to
version future changes to the Code of Conduct going forward, for
maximum awareness and transparency for changes.
- Anchors: Add section anchors to headers, to make them more static and
less likely to change over time. This will break old links… but I
think it is better to be explicit and use SEO-friendly header anchors
as a standard going further.
All of these changes do not represent content or interpretative changes
to the Fedora Code of Conduct or the behavior we expect people to hold
themselves accountable to. Therefore, I am making these changes
unilaterally and pushing directly to `main`.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit addresses feedback that came up in a Fedora Discussion topic
about whether Telegram groups are official or unofficial. The Code of
Conduct was written at a time when we were only beginning to use Matrix
more formally in the project. Since the time that the Code of Conduct
was published, we have now shifted completely to Fedora Discussion and
Fedora Chat/Matrix as our official chat platforms, as verified by the
Communications page.
It might be more wise to link out to the Communications page in the
Project docs, but for now, this commit addresses an important
clarification about where the Code of Conduct is more rigidly applied
and where it is more challenging to enforce.
ref: https://discussion.fedoraproject.org/t/the-status-of-the-telegram-groups-within-the-project/172185/13
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
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>
In a past commit, I removed Josh Berkus (@jberkus) and Laura Santamaria
(@nimbinatus) as current members of the Fedora Code of Conduct
Committee, but I forgot to add them as past members in the
documentation. This commit fixes this. Thanks @jonatoni for pointing
this out to me!
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit formally ends the terms of Josh Berkus (@jberkus) and Laura
Santamaria (@nimbinatus) in their temporary role as Fedora Code of
Conduct Committee members. It also formally begins the terms of Ankur
Sinha (@ankursinha) and Chris Onoja Idoko (@chris) as the newest members
of the Committee. Ankur and Chris are joining as permanent members.
The `codeofconduct@` email alias and other Committee processes are in
the process of being updated or have already been updated at time of git
commit.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit adds Josh Berkus and Laura Santamaria as temporary members
of the Fedora Code of Conduct Committee, starting from today, July 7,
2025 until September 30, 2025. The Code of Conduct Committee approved
their nominations today, and this commit represents their formal
onboarding as new members of the Committee.
The temporary nature is to provide coverage for the Fedora Code of
Conduct Committee in light of some of our recent retirements from past
members, and my leave of absence which will keep me away for an extended
period of time. Since both Josh and Laura have previously received code
of conduct training, they have the necessary background to be effective
immediately in this role, together with the other existing members of
the Fedora Code of Conduct Committee.
ref: https://pagure.io/CoC/issue/355
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
I also consistently used one sentence per line, but broke the lines on
the parentheses, so the names are easier to quickly read in an editor.
Also, I moved part of the information about reports as sub-bullets under
the primary bullet about the responsibility of writing reports.
Since membership of the Code of Conduct Committee is one of the most-
likely things that someone would want to find from this document,
elevating it to the top of the document seems like better information
architecture to expose the useful information and make it indexable
under a heading.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit updates the public documentation following the last meeting
of the Fedora Code of Conduct Committee earlier this week. The changes
in this commit are summarized below:
* Miscellaneous style fixes to formatting and use of whitespace.
* Added anchors for all headers, to create better permalink URLs.
* Added Jef Spaleta as a new member of the CoC Committee, as the new
Fedora Project Leader.
* Removed Matthew Miller and Marie Nordin as current members, and moved
to them a list of past members. It is a list for now, but later, this
could be a table like exists in other parts of Fedora Council docs.
* Removed Dorka Volavkova as a full member of the CoC Committee, with
the intention of adding a new sub-structure for a Fedora Flock On-site
Response Team, using a special mail alias to reaches a wider pool of
people for faster, more prioritized responses to events which are in
our realm of control as organizers. Dorka will re-appear in this new
sub-structure, once it is proposed. Along with Natalie Pazmiño, Shaun
McCance, and Amy Marrich.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
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.
ClosesFedora-Council/tickets#485.
ref: https://pagure.io/Fedora-Council/tickets/issue/485
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
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>
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>
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>
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>
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>
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>
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.
ClosesFedora-Council/council-docs#84.
ref: https://pagure.io/Fedora-Council/council-docs/issue/84
Signed-off-by: Justin W. Wheeler <jwf@redhat.com>
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>
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>
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.
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>
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>
This commit updates the organization chart with the 2023 changes by
@riecatnor. This is the current and most up-to-date reflection on the
Fedora community and where we are today.
ClosesFedora-Council/council-docs#194.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
