This commit fixes all Antora configuration files for the components
underneath this repository. When you run the build script, it reports
errors that it is unable to find the reference for the `start_path` for
all of the components. This is because the full path is required,
including the `.adoc` file ending. So, this commit makes the path
explicit and therefore, fixes the errors.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
NOTE: This commit does NOT change content, policy, or the substance of
any written documentation that requires Fedora Council review. This
change only impacts changes related to the Antora toolchain.
This commit integrates the team directory profile that was introduced a
few years ago into the Fedora Council documentation. This makes several
common URLs used across the Fedora Council Antora component accessible
as macros. Instead of hard-coding the same URL across all of the Fedora
Council documentation, the macros can be used to more easily re-use the
same URL consistently across multiple pages.
This commit is one of several that gradually refactors the Fedora
Council documentation to properly fit into an AsciiDoc and Antora
workflow.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
This commit updates the official record to note that the Fedora DEI
Advisor role transitioned from @siddharthvipul1 to @jonatoni in
September 2023.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
This commit makes official the change of the Fedora DEI Advisor from
Vipul Siddharth to Jona Azizaj for the Fedora Linux 39 release cycle.
ref: https://gitlab.com/fedora/dei/home/-/issues/21
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
This commit fixes the `xref` links used throughout the Fedora Council
documentation to the DEI Team documentation. The Antora component name
changed from `/diversity-inclusion/` to `/dei/`.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
The link previously goes to a category that does not exist anymore.
Instead, it is now replaced by a link to the Discourse tag, where the
discussions actually happen now.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
The Fedora Docs theme now provides a table-of-contents in the theme, so
it is not necessary to have the duplicate in the document.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
We are using an old version of the Fedora Docs theme and UI package.
This commit updates the local Antora config used for the local preview,
so that anyone working on the Fedora Council docs would also see the
same preview locally that they would expect on the production site.
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>
This commit fixes the story and original title of the Fedora Community
Architect and its many different historical iterations. This came up in
private message with @mattdm, when he pointed out to me that I missed
some details in how I explained the history of the role title and how we
got to where we are today.
Furthermore, based on the suggestion of @mattdm and other low-vision
users on Fedora Discussion, I dropped the use of punctuated acronyms as
this did not have the desired impact I thought I was making for screen
reader users. So, to respect the feedback of those who participated in
the discussion, I am ending this precedent and will move back to
acronyms not broken with punctuation.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
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>
This commit adopts the current best-practice for using partials in
Antora within the Council docs, and it also adds an attributes partial
that includes common metadata used across the Council docs. The partials
are not yet used across the Council docs, but the attributes partial is
imported into the headers of multiple documents.
This is setting the stage to make updating things like our Discourse,
Matrix, and other comms places easier to maintain and update.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
This commit updates information about how to contact the Fedora Council
and the best places to get in touch. This updates information about IRC
and mailing lists, and replaces them either with platform-agnostic
language or Matrix/Discourse specifically, where applicable.
This commit builds on what @mattdm already put together in January 2022
in PR #138. There is not a significant change to what was already voted
on and decided previously, but I did reorganize some of the content on
the "Contact" page in an attempt to enhance the page structure already
laid out. It includes @bcotton's feedback asked for previously.
These changes are a year old and do not include changes to the charter
other than links to the Council meetings wiki page and changing the
Discourse link from the old category to the Council tag. I intend to
merge this on commit, on the conditional affirmation by the Council has
approved this change during our February 2023 face-to-face meeting in
Frankfurt, Germany.
ref: Fedora-Council/council-docs#138
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
This commit follows in-person discussion by the Fedora Council in our
2023 Council hackfest in Frankfurt, Germany. We agreed to convert
"Objectives" into "Community Initiatives", which we agreed was easier to
understand and communicate the roles of these efforts in the project.
There is no functional change to Objectives. It is just a cosmetic
change, and we will follow this change with more communications about
the transition to bring more excitement into Initiatives.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
This commit documents the existence and occurrence of in-person meetings
by the Fedora Council, typically held on an annual basis or shared with
other major events like Flock or DevConf conferences. These meetings are
not actually a secret, since we already plan and discuss the agenda for
these meetings in open, public channels. However, our charter does not
mention them, and it should!
This pulls the same language used by @mattdm in a previous Pull Request.
Since that PR has a merge conflict and this change is already approved,
I am facilitating it in a new Pull Request.
Additionally, this change continues the gradual migration of our entire
charter to follow the same AsciiDoc conventions shared by other docs in
the Fedora community, e.g. one sentence per line. Some semantic changes
were also made for brevity.
I am pushing this commit as conditionally approved along with other in-
person discussion happening the week of 6 February 2023 in Frankfurt,
Germany.
ref: Fedora-Council/council-docs#170
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
This updates a link to the Fedora Join docs to use a `xref` cross-module
link instead of hard-coding a URL.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
This commit changes the Fedora Council charter to use updated language
about the Diversity, Equity, & Inclusion Advisor. In 2017, the role was
changed to "Diversity & Inclusion Team Representative", but in its real
function, this was not how the role was utilized in the Council. For
some time, the DEI Team documentation reflects the role as "DEI Advisor"
while the official Council charter does not reflect this. So, the main
change in this is updating the language to match what the DEI Team
includes as role documentation for the DEI Advisor to the Council.
Additionally, the DEI Advisor is now moved from an auxiliary seat to a
full, voting member of the Fedora Council. This is a step as a whole to
retire the auxiliary seats and give every member of the Council an equal
voice and impact in voting and decisions. In function, this is how the
Council already works, but our charter is not reflective of this and
technically the charter is the ultimate truth.
This follows an in-person conversation with @mattdm, and by opening a
Pull Request for this change, requires a Council vote to update the
charter.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
