Fixes#55
The guide is now split into 2 modules:
* `team-info`, which contains our team information
* `contributing`, which contains the actual contributing guide
Each has its own navfile etc. Configs have all been updates so that outwardly, everything looks like it did before (although I did shuffle the table of contents a little bit based on @pboy's suggestions in #55). The default index is now `team-info/index.adoc` (see `antora.yml`); that's the one you'll see when you build the guide - it's the original index.
I also made sure each file has an include for the attributes file and `:experimental:` at the top, and cleaned up the config YMLs a little bit.
Reviewed-on: docs/team-docs#63
Reviewed-by: Jan Kuparinen <copperi@noreply.forge.fedoraproject.org>
WIP pull request for ticket [#11](docs/tickets#11), the introduction page for contributing to Fedora Docs.
Summary of changes so far:
- added small motivational paragraph
- suggest title streamline
- updated editing approaches to encourage local workflow
- reordered tools to have local workflow as the first item
- added links to local and web editing guides
- added visual contributor journey diagram
- added explanation diagrams for the site and for review process
- added various other explanations
- general revisions
- removed tool section on direct edit to upstream
Co-authored-by: Eli Ridge <>
Reviewed-on: docs/team-docs#59
Reviewed-by: Peter Boy <pboy@noreply.forge.fedoraproject.org>
This commit makes two primary changes:
- Fix a broken `xref` link to the Fedora DEI Team documentation, which
recently changed Antora component names from `/diversity-inclusion/`
to `/dei/`.
- Update the example of an attributes file using the latest example from
the Fedora DEI Team. This is a more comprehensive example of how to
use attributes/partials based on the current practice in the DEI Team.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
