This commit changes the language of "Fedora Women's Day" to "Fedora Week
of Diversity", as documented in Pagure issue #225.
Co-authored together with Christopher Klooz (@py0xc3).
ref: https://pagure.io/fedora-diversity/issue/225
This commit is a significant refresh of the Fedora DEI Team docs based
on our current best practices and team workflows, as described below:
Update attributes
=================
This was the largest change made to the docs. Our attributes file was
updated, in response to feedback that the links to our Fedora Discussion
pages were broken after the recent change from `#dei` to `#dei-team`.
There was not advance notice made to the team about this change, so the
links are now broken and need to be updated so people are directed to
the correct place for our discussions.
While doing that, I pulled the template file from the Engineering and
Mindshare docs maintained in the Council docs repository to use as a
model. I updated our platforms from the template and then used the
attributes as much as possible throughout our docs. There is more work
to do, but in the future, this will make metadata updates easier. There
will only be one place to update URLs should they ever change in the
future.
Refresh index page
==================
* Remove mention of podcast interview because the link is now offline.
* Change ticket tracker mentions from Pagure to GitLab.
* Drop mention of the mailing list and point to Fedora Discussion tag.
* Update information on where to find the team to just use Discourse and
Matrix; we should try to funnel people to the places where the team is
most active and connected to the rest of the Fedora community.
* Reframe the platforms on where to find us as "synchronous" and
"asynchronous" instead of using platform names.
Refresh getting involved and meeting guide pages
================================================
* Used more `xref`'s to external team documentation where applicable
(e.g. Fedora Legal and Fedora Infrastructure).
* Update context of our communication platforms to not mention mailing
list or Telegram group as primary ways to engage with the team.
* Drop Pagure in favor of GitLab for ticket-based task tracker.
* Fix formatting and minor flow improvements for explaining how to
become a sponsored member of the DEI Team.
* Add social agreement and meeting format from the HackMD notepad.
Miscellaneous changes
=====================
* Per discussion with @mattdm and low-visibility users on Fedora
Discussion, stop using punctuation marks to distinguish acronyms. This
was originally done for the benefit of screen reader users, but this
guidance is now out-of-date with how most screen readers work, based
on community feedback.
* Change "Fedora Women's Day" to "Fedora Week of Diversity" where it was
not already changed.
* Stop using `:toc:` attribute in pages, since the Fedora Docs theme now
includes a table-of-contents in the sidebar by default.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
PR #245: Address @samccann and @amsharma comments
* Remove "Don't be shy" line from the instructions in posting a self-
introduction.
* Add a link to the `diversity-team` FAS group so people seeking a
sponsor can see who is already a sponsored member of the DEI Team.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
This commit updates the Pagure README, Fedora documentation, and other
miscellaneous files in the repository to reflect our new team name. We
added "Equity" into the team name to better reflect the focus and
intended impact of our work. This was discussed in team meetings and
Pagure tickets before finalizing.
Closes#206.
Signed-off-by: Justin W. Flory (he/him) [Fedora Project] <jwf@fedoraproject.org>
I reviewed this page today and was surprised to discover that somehow,
this file has an older state from when we were solving merge conflicts.
Oh no!
I tried to mitigate by cleaning up the mistakes and typos. I also
reorganized the format in an attempt to de-duplicate some information.
Git merge conflicts bite hard sometimes!
Signed-off-by: Justin W. Flory (he/him) <git@jwf.io>
The old method of using partial imports in the `pages/_partials/`
directory was deprecated in Antora. This commit moves the existing
attributes to the new file path.
I also updated a few of the attributes, like `MAJOROSVER` from 32 to 33.
Signed-off-by: Justin W. Flory (he/him) <git@jwf.io>
* edited the heading for communications paragraph
* edited link for IRC web chat
* added link to channel in Matrix
* restructured landing page
* tried to fix xref links
updates to meeting info, removing outdated information. minor tweaks to the events description
Added updated calendar for next meetings information.
Closes#116.
This commit adds the 2020 infographic created by @smeragoel into our
docs repository. It also adds it to the home page for the D&I docs. I
figure a visual says a lot more than pictures, so I placed it near the
top of the document.
I also added a table of contents (`:toc:`) to help make the content on
the lower part of the page more known and not buried by the infographic.
Closes#154.
Signed-off-by: Justin W. Flory (he/him) <git@jwf.io>
This squashed commit is representative of @ramyaparimi's work in
splitting out the D&I docs into more manageable, smaller pieces.
Beginning with an Events module. Her squashed commit messages are below:
created a D&I events dropdown.added FWD under it.
added path to partials
removed Fedora Women's Day tab from ROOT nav.adoc
probably fixed attributes issue
partials changed to new antora syntax
moved FWD dir to new events module
created a D&I events dropdown.added FWD under it.
probably resolved merge conflicts
made tiny changes
made changes suggest, made content changes for better flow
I removed line numbers that were accidentally included in the previous
commit, and I also did some other miscellaneous formatting and syntax
clean-up where I saw a need.
Signed-off-by: Justin W. Flory (he/him) <git@jwf.io>
This commit is a follow-up to PR #117. That PR added a new
`_partials/attributes.adoc` file with reusable macros. This commit
actually implements the macros across our docs. This updates a lot of
links to use the macros for the Fedora Wiki. I also changed some links
from Fedora Wiki URLs to `xref` macros, since some page we linked out to
are now hosted in our docs site.
Signed-off-by: Justin W. Flory <git@jwf.io>
Better seperate out the content about diversity and inclusion efforts in
Fedora from the content about the actual D&I Team. It is duplicated as
it is right now.
