This commit updates our team documentation for how we conduct meetings.
Notably, the instructions for how to add an issue to the meeting agenda
now mentions GitLab milestones and the commands from IRC Meetbot are now
migrated to Matrix Meetbot.
Related to fedora/dei/home#18.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
This commit reflects changes made in the HackMD pad by the DEI Team
together in our 2023-10-26 meeting. This better captures what is
expected of the Fedora DEI Advisor in the role.
Contributes to fedora/dei/home#20.
ref: https://hackmd.io/@fedora-dei/BJGZCy4zp
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
📝 docs(roles): DEI Advisor. Change meeting requirements, budget duty.
The commit integrates feedback from @jonatoni and @rowright in Merge
Request fedora/dei/docs!5. Notably, two changes are made:
* Require attendance at one of two monthly meetings
* If unavailable, provide advance notice to team or Meeting Chair
* Remove mention of working with Community Architect to manage DEI
budget. Historically, the team had this funding because it paid for
Outreachy internships, which was headed (at the time) by the Diversity
Team.. Today, this money is centrally spent by the project each year.
I think if the DEI Team needs funding for project-specific work, we
should either work with the Mindshare Committee (i.e. for events) or
the Fedora Council (i.e. supporting DEI communities in Fedora).
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
➕ docs(roles): Address feedback in MR !5
* Remove requirement for Code of Conduct Committee seat
* Update contact information for DEI Advisor to match current location
of the team (i.e. Fedora Discussion, Fedora Chat)
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
I mean, Fedora Linux 39 is not quite yet here… but the beta is out. So,
this seems like a preemptive change that prepares for the future ahead.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
This fixes the automatic detection of contributing guidelines so that
GitLab will make them more visible in the GitLab.com UI for this repo.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
We were 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 DEI Team 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 addresses more warnings and errors raised by Antora during
the site build process, as shown in the CI pipeline. Now, the references
to the DEI Advisor role page are made internally within our own docs. I
also removed the table-of-contents from the DEI Advisor role page due to
a conflict with the Fedora Docs theme which also shows a table-of-
contents in the sidebar navigation now.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
Antora gives two warnings about not being able to find the start page
for this site, so this commit addresses that by fixing the most likely
issue for the generation of these warnings.
```
WARN (@antora/content-classifier): Start page specified for site not found: diversity-inclusion::index
WARN (@antora/content-classifier): Start page specified for master@diversity-inclusion not found: ROOT:index
```
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
This commit adds a GitLab CI configuration to automatically test and
build previews for new Merge Requests submitted against this repository.
It provides an easier way to validate changes before merging them to the
`main` branch.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
This repository is not used for DEI Team day-to-day planning and work,
so this commit updates the README to explain the purpose of this repo
and how best to get help and guidance.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
This repository previously had a CONTRIBUTING.md file to explain how to
contribute to the DEI Team documentation. This commit updates the
information in the guide and also puts it into the correct place so that
GitLab is able to detect the guidelines.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
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>
A minor change to the `build.sh` script used for generating local
preview of the docs. This pulls in minor changes that make the script
work better across multiple operating systems and platforms.
Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
