Commit graph

11 commits

Author SHA1 Message Date
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
65a7d69b74
♻️ docs(council): Refactor partials, remove unused partials
This commit does some behind-the-scenes meta-work to prepare for some
other changes that warrant bigger discussions. However, I phased out the
`FWIKI` and `COMMBLOG` attributes for `url_wiki` and `url_commblog`
respectively. This matches the convention used in other Fedora Docs
repositories.

No changes were made to docs content itself. All information should
display just as it did before this commit.

Signed-off-by: Justin Wheeler <jwheel@redhat.com>
2025-07-07 14:22:40 -04:00
de0d38c5a7
Docs: Convert all docs to native AsciiDoc
This commit is a significant refactor of all the Fedora Council
documentation into full, native AsciiDoc. This includes following
conventions commonly associated with AsciiDoc, such as the one sentence
per line convention and using more internal `xref` links across pages.
It also introduces explicit link anchors on all headings.

This commit is mostly invisible to the reader. All lines across the
Antora component are now written on one sentence per line, as per the
standard AsciiDoc convention. Following this convention makes future git
diffs easier to read when it comes to actual changes in meaning.

Additionally, where applicable, I updated names and titles of roles that
have since been changed, e.g. "Fedora Community Action & Impact
Coordinator" to "Fedora Community Architect".

Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
2023-10-19 23:28:55 -04:00
8a66455ed5
docs(council): Replace "Council" with {team_name}
This commit changes almost every occurrence of "Council" and "Fedora
Council" with `{team_name}`, an Antora macro that resolves to "Fedora
Council". This continues the integration work with the team profile
introduced in previous commits. It ensures consistent use of the Fedora
Council name in our documents and may also contribute to a slight boost
in search engine optimization.

Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
2023-10-14 21:10:55 -05:00
bdaaa7a85d
docs(council): Introduce macros via Antora partials
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>
2023-10-14 20:32:53 -05:00
c9543d027a
Migrate default git branch from master to main (closes #86)
Last month, GitHub switched their default git branch from `master` to
`main`. So, if GitHub is doing it for their millions and millions of
repos and users, there are few good reasons not to for this repo.

    https://github.com/github/renaming

This commit changes all references of `master` to `main` in the Antora
site configuration. This commit is already pushed to a git branch,
`main`, on the council-docs repo. But this commit will be opened as a
Pull Request to the `master` branch.

**Do not merge without coordinating on the fedora-docs/docs-fp-o PR**.
If the builder is still configured to build onto `master`, well, that
obviously will not work. Please coordinate these changes simultaneously.

Closes #86. cc: @mattdm

Signed-off-by: Justin W. Flory (he/him) <git@jwf.io>
2020-11-13 18:12:47 -05:00
1ff2d697d7 review of team directory mechanics 2020-09-16 14:22:38 +02:00
Ben Cotton
3b62bb9d99 I found a few places I was wrong 2020-08-27 16:28:39 -04:00
Ben Cotton
4d417699d3 Add some info about the mechanics of this that are hopefully not lies 2020-08-27 14:49:34 -04:00
Ben Cotton
6fb1303b05 Add an explanation of what I mean by "Teams" based on feedback from council-discuss 2020-08-27 14:39:53 -04:00
Ben Cotton
bc78f05513 Add documentation about the team directory
This should help address the concerns raised in last week's Council meeting.
2020-08-26 12:23:25 -04:00