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>
Today, on 7 May 2026, @dcantrell wrote his resignation on the Fedora
Council private list, effective immediately. This commit processes the
resignation in our documentation, marking the Engineering Rep seat as
vacant and noting the end of Dave's term on the History page in Council.
Closescouncil/tickets#567.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
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 imports the Community Ops Team default issue template. It
leverages some of the new features we have on Forgejo with the front-
matter configuration and issue forms, such as providing default issue
labels on new issues.
A config file is also provided, to give some other link options that
someone will see when opening a new issue, such as our Matrix room and
the Fedora Discussion tag for the Council.
Hopefully, this gives us a framework to have more useful, structured
data for new tickets that the Fedora Council receives. It is sort of
forced too, as all new issues cannot use a blank issue; they must use
the default template.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit reworks the Fedora governance docs repository README to be a
better match to how the CommOps docs repo README looks. It provides more
up-to-date information about building and testing the docs, and also
adds info about about how to contact the Fedora Council.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This makes the README consistent with the source content found in this
repository. No other content was edited beyond converting the original
text from Markdown to AsciiDoc.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit edits the frontmatter of the Fedora AI-Assisted
Contributions Policy to clearly note the document version (v1.0, the
original and first version) and the date of the publication, which was
when the git commit was merged into this repository on Friday, October
24th, 2025.
No changes to policy content; this just makes it easier for ourselves
and the rest of the world to understand the versioning and cadence of
our own policy documents. It also subtly encourages us to maintain a
changelog, so we can always clearly explain what changes we made and
why. Transparency++
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 adds some new lines and generally cleans up and organizes
the file. The most notable difference here is that the `preview.pid`
lockfile will not be accidentally committed to the repo.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit pulls the latest upstream `docsbuilder.sh` script into the
Fedora Docs repository for the Council. I also edited the multi-line
message from our `preview.sh` script so that the terminal output still
shows the links to the various sites built from this repo.
The best benefit to this change is that you can run the script when you
start development, and any changes you save to files tracked in the dev
container will quickly appear. No more stopping and starting again.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit adopts the One Sentence Per Line convention for @churchyard
biography. I also use Fedora Wiki shorthand macro to make the overall
line length shorter.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit adds @nimbinatus's biography provided in the Pagure issue
into the Council Members page for the Fedora bootc Initiative.
I also standardized the naming of all active Initiatives on the Members
page, because it was somewhat inconsistent and bothered me.
Fixes#278.
ref: https://pagure.io/Fedora-Council/council-docs/issue/278
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit adds the Fedora Docs 2025 Initiative as an approved
Initiative to the Fedora Council documentation, and also publishes the
biography provided by @pboy in the ticket for his bio.
Fixes#272.
ref: https://pagure.io/Fedora-Council/council-docs/issue/272
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>
This commit updates the Fedora Council documentation to account for the
people who are currently serving as members of the Fedora Council.
@dcantrell goes by Dave now, so I changed that. I added @t0xic0der as
the new Mindshare Committee representative. I also removed @jasonbrooks
from the current members of the Council and moved him and his Initiative
as a past member of Council.
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 is the initial commit of the AI-Assisted Contributions
Policy, as voted on and approved by the Fedora Council on Wednesday, 22
October 2025. This text is an AsciiDoc representation of the policy text
approved in the ticket. Very few minor changes were made at commit time:
1. Bullet levels: For the Transparency rule, I used bullets at further
sub-levels / indentions to more clearly organize the information in
AsciiDoc. This also more clearly ties the sub-levels to the
Transparency rule. The original text simply used whitespace, which
is not obvious how to do in AsciiDoc.
2. Wiki page categories: I added a new type of disclosure at my own
discretion, about how content creators can declare the use of AI when
using it for writing Fedora Wiki pages. Fedora contributors can use a
new Fedora Wiki category to "declare" the use of generative AI on
Wiki page content. I linked to the Fedora Wiki category page in the
policy document. This was not in the original draft, but it does not
change the interpretation or substance of the policy itself. Since it
provides further context about how contributors should appropriately
declare the use of generative AI, this felt like an appropriate
change to slip in without triggering another round of voting.
3. Author credit: I credited @jasonbrooks, the Fedora Council, and the
Fedora community as authors of this policy, in recognition of the
work that Jason specifically did in crafting the policy, the input of
the Fedora Council in shaping the final version of the policy, and of
course, the valuable input from our diverse, global community of
contributors who helped us shape this policy over several weeks, if
not months (depending when you consider this work as having started).
ClosesFedora-Council/tickets#542.
ref: https://pagure.io/Fedora-Council/tickets/issue/542
ref: https://discussion.fedoraproject.org/t/fedora-council-meeting-2025-10-22-ai-policy-approved-docs-initiative-proposed/169630
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit is a consolidation of a few things. It is mostly docs-nerd
stuff that, probably, nobody cares about except for me maybe me. But if
you do see this and think it is nifty, well, I accept payment in Fedora
karma cookies!
* Rename the `historical_note.adoc` page to `index.adoc`, effectively
making it the landing page for the `/historical/` directory altogether
* But then I went and changed `/historical/` to `/archive/` because it
drives me batty when I go to tab-complete in the terminal and I have
namespace collision with both `/historical/` and `history.adoc`. This
will never happen again.
* Use page aliases to avoid accidentally breaking any permalinks to the
old pages, in the very unlikely but still possible scenario that
someone linked or bookmarked these old pages before. We like to keep
working URLs here, we do! It is true!
Anyways, I should probably go to sleep soon.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit brings the Fedora Council docs to be more in-line with the
example set by the Fedora Community Ops team. It introduces several new
attribute variables to help avoid repetition across the docs, and also
makes it easier to update the names and links of things later. (AHEM,
Forgejo, I am looking at you.)
In some other places in the docs other than the new team profile on the
index page, I changed the hard-coded names of things to use the newly-
introduced attribute variables.
Hurrah, keep it DRY, folks!
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit makes various small improvements to the Fedora Operations
Architect page. Namely, it makes the owners of each responsibility more
clear by adding each assignee's FAS username to the header, uses tables
for the contact information for each responsible person, and fixes a few
minor spelling and grammar mistakes.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit changes the Fedora Discussion URL used for the Fedora
Council to use a more specific URL. Instead of only specifying the tag,
it also specifies the category *and* the tag, helping ensure topics
about the Fedora Council do not land in Ask Fedora by mistake.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
- Add bio for Ryan Lerch as Git Forge Initiative Lead
- Highlights involvement with Fedora since 2008
- Notes founding editor role with Fedora Magazine
- Describes current work on Git Forge Initiative
Resolves#257
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>
