#186 Create new roles module, add D&I Advisor doc (closes #89)
Merged 3 years ago by jflory7. Opened 3 years ago by jflory7.
jflory7/fedora-diversity add/advisor-role  into  master

file modified
+5 -1
@@ -11,9 +11,13 @@ 

  # We encourage you to name the index page as "index.adoc". If you absolutely have to use a different name, please reflect it here. You can ignore this field otherwise.

  start_page: ROOT:index

  

- # This lists all the menu definitions of your component.

+ # Navbar element. Anything added below appears in the docs.fp.o site navbar.

+ #

+ # NOTE: If you want to add to the sidebar, look at the `nav.adoc` file in a

+ # module first. If you create a new module, add its `nav.adoc` file below.

  nav:

  - modules/ROOT/nav.adoc

  - modules/survey/nav.adoc

  - modules/events/nav.adoc

  - modules/outreachy/nav.adoc

+ - modules/roles/nav.adoc

@@ -0,0 +1,2 @@ 

+ * Role Handbooks

+ ** xref:council-advisor.adoc[Council D&I Advisor]

@@ -0,0 +1,168 @@ 

+ include::ROOT:partial$attributes.adoc[]

+ 

+ = Fedora Diversity and Inclusion (D&I) Advisor

+ :toc:

+ 

+ (xref:council:ROOT:members.adoc[_Return to "Current Members of the Fedora Council"_])

+ 

+ The *Fedora Diversity and Inclusion (D&I) Advisor* is a liaison between the Fedora Council and the Fedora Community on topics and issues related to diversity and inclusion in Fedora.

+ The D&I Advisor works with Fedora Council leadership to represent perspectives and voices of the Fedora Community in decision-making and project discussions.

+ Additionally, they also lead initiatives to assess and promote equality and inclusion in close collaboration with the xref:ROOT:index.adoc[Fedora D&I Team].

+ 

+ 

+ [[current-advisor]]

+ == Current D&I Advisor

+ 

+ [.profile-picture]

+ image::https://jwf.io/static/logo.jpg[Justin W. Flory (he/him), taken January 2020.]

+ 

+ https://jwf.io/[Justin W. Flory] (he/him) first joined the Fedora Project in August 2015.

+ He was a founding member of the xref:commops:ROOT:index.adoc[CommOps team], xref:ROOT:index.adoc[Diversity & Inclusion team], and xref:mindshare-committee:ROOT:index.adoc[Mindshare Committee].

+ You can read more about his Fedora activities https://jwf.io/#fedora[on his website].

+ 

+ In Fedora, Justin is most passionate about the Fedora Community and its people.

+ Throughout his time in the Fedora Community, Justin appreciates that one of the most unique aspects of Fedora is its diversity.

+ He was inspired to contribute to the Diversity & Inclusion Team after noticing an absence of people who looked like him in D&I conversations across the Open Source world.

+ He is excited to have the opportunity to contribute to Fedora in this capacity and hopes to use his privilege to be an advocate for the needs and concerns facing the Fedora Community.

+ 

+ 

+ [[duration]]

+ == Duration of service

+ 

+ The D&I Representative will serve until they wish to step down, or the Council or the D&I Team wish to replace them.

+ The recommendation for duration of service is two Fedora release cycles, or *one year*.

+ However, terms may (xref:#history[and have]) run shorter or longer depending on the personal situation of the person filling the Advisor role.

+ 

+ In the event that the representative, Council, or D&I Team wish to make a change in representative, sufficient reason should be given.

+ A new representative will then be xref:#selection[selected] by the D&I Team.

+ 

+ 

+ [[responsibilities]]

+ == Responsibilities

+ 

+ The Fedora D&I Advisor is a liaison between the Fedora Council, the Fedora D&I Team, and the Fedora Community.

+ The following responsibilities and duties are delegated to the D&I Advisor.

+ 

+ [[responsibilities-council]]

+ === To Fedora Council

+ 

+ * Participate in two to three Council hackfests a year

+   (xref:#hackfest[_what is a hackfest?_])

+ * Participate in two to three  Council meetings a month, as representative of the D&I Team

+ * Identify synergies and collaboration opportunities with Fedora Council responsibilities, Fedora D&I Team objectives, and the Fedora Community

+ 

+ ////

+ [[responsibilities-council-examples]]

+ ==== Examples

+ 

+ Links to tickets or concrete examples of these responsibilities should eventually go here.

+ ////

+ 

+ [[responsibilities-diversity-team]]

+ === To Fedora D&I Team

+ 

+ * Participate in two to three Diversity & Inclusion meetings a month

+ * Share periodic updates and insight on Council tasks and priorities back to the team

+ * Maintain and update team documentation for any key objectives and the D&I Advisor role page

+ * Maintain https://budget.fedoraproject.org/budget/FY20/d-i.html[Fedora D&I budget documentation] in coordination with xref:council::fcaic.adoc[Community Action and Impact Coordinator]

+ 

+ ////

+ [[responsibilities-diversity-team-examples]]

+ ==== Examples

+ 

+ Links to tickets or concrete examples of these responsibilities should eventually go here.

+ ////

+ 

+ [[responsibilities-community]]

+ === To Fedora Community

+ 

+ * Listen to needs, concerns, and hopes of the Fedora Community for Fedora

+ * Be an intersectional advocate for the diverse Fedora Community to Fedora Leadership

+ * Act as a source of support and/or mediator in concerns or incidents

+ * Make explicit invitations for Fedora Community events and provide financial support to do so when needed

+ * Promote inclusion in the Fedora Community

+ 

+ ////

+ [[responsibilities-community-examples]]

+ ==== Examples

+ 

+ Links to tickets or concrete examples of these responsibilities should eventually go here.

+ ////

+ 

+ 

+ [[selection]]

+ == Selection

+ 

+ This section explains how the D&I Advisor is nominated and confirmed.

+ The selection process documented below is initiated when a rotation of Advisors is motioned by the existing representative, the Fedora D&I Team, or the Fedora Council.

+ 

+ [[selection-nomination]]

+ === Nomination

+ 

+ There will be a one-week nomination period for potential representatives.

+ Nominees can be self-nominated or nominated by others with their consent.

+ A prospective nominee should understand the dynamics of the Fedora D&I Team, a basic understanding of various Fedora sub-projects, and have sufficient time to perform the responsibilities required.

+ Nominees are required to be members of the Fedora D&I Team.

+ 

+ In the event that there are no nominees, the D&I Team will work with the Council to broaden the search message and request more time.

+ Should no nominees be found after that, the role will rotate among existing D&I Team members until the next representative is identified.

+ 

+ [[selection-confirmation]]

+ === Confirmation

+ 

+ After the one-week nomination period expires, the Fedora D&I Team will discuss candidates in a public meeting.

+ In a meeting discussion, it provides an opportunity for the team to weigh in and share other context.

+ In the event that more than two nominees are both interested in the Advisor role, the Fedora D&I Team will coordinate with the xref:council::fpgm.adoc[Fedora Program Manager] to run an election.

+ 

+ For the Fedora Elections application, use these conditions:

+ 

+ * Nominee must be a member of `fedora-diversity` F.A.S. group

+ * Voting is open to CLA+1 voters (like Council elections)

+ 

+ The selected person and the Council will be notified once the selection is confirmed.

+ The selected person will begin serving as the D&I Advisor to the Council as soon as possible.

+ 

+ 

+ [[contact]]

+ == Contact

+ 

+ Get in touch with the Fedora D&I Advisor in the following places:

+ 

+ * *IRC*:

+   link:[#fedora-diversity] on https://freenode.net/[freenode IRC]

+ * *Matrix/Element*:

+   https://app.element.io/#/room/#fedora-diversity:matrix.org[#fedora-diversity:matrix.org]

+ * *Telegram*:

+   https://t.me/fedoradiversity[@fedoradiversity]

+ * *Email*:

+   diversity `AT` fedoraproject `DOT` org

+ 

+ 

+ [[history]]

+ == History of Fedora D&I Advisor

+ 

+ |===

+ |Releases  | Advisor

+ 

+ |33, ...

+ |{FWIKI}/User:Jflory7[Justin W. Flory]

+ 

+ |29, 30, 31, 32

+ |{FWIKI}/User:Jonatoni[Jona Azizaj]

+ 

+ |27, 28

+ |{FWIKI}/User:Amsharma[Amita Sharma]

+ 

+ |23, 24, 26, 26

+ |{FWIKI}/User:Tatica[Maria "tatica" Leandro]

+ |===

+ 

+ 

+ [[appendix]]

+ == Appendix

+ 

+ [[hackfest]]

+ Hackfest::

+ A hackfest is a multi-day "team sprint" where Fedora contributors gather together to work towards one or two clear objectives or goals.

+ Pre-COVID, teams could propose their own budgets for arranging travel, booking accommodations and a venue, and other support costs for bringing people together.

+ During COVID, hackfests sometimes take the form of multi-day events spread out over multiple weeks, i.e. one 4-5 hour call a week for

This commit makes the following changes:

  • Antora: Create new roles module for role handbooks
  • roles: Add D&I Advisor role page (closes #89)

This commit creates a new Antora module called roles. This module will
be a place to collect profiles of team responsibilities and how you can
contribute to the team. For now, it will just feature the D&I Advisor
role, but I am excited to see this expand to other things too.

This commit also adds a first draft of the D&I Advisor role to the docs
page. This page was adapted from the existing document in the Council
docs repo:

https://docs.fedoraproject.org/en-US/council/diversity-advisor/

I used this as a base and modified it. I plan to follow up with a Pull
Request to the council-docs repo to remove that page and replace links
with redirects to the D&I Team docs page.

I did make changes though. I used the FESCo representative role page for
many of the additions around duration and the selection process:

https://docs.fedoraproject.org/en-US/fesco/Fedora_Council_Engineering_Rep/

Closes #89. Finally!

Screenshot of local preview of the new role page for the Fedora D&I Advisor

rebased onto c655d31

3 years ago

Metadata Update from @jflory7:
- Pull-request tagged with: new change, type - docs

3 years ago

It is really nice to have everything related to D&I in one place :100:
+1 from me :grinning:

Looks Good to me, I wonder if there's a way we can mirror the Council Page for D&I Advisor for it, What do you think ?

Thanks for the +1's @ramyaparimi and @nasirhm. :tada: I think this is OK to merge from a team point-of-view. Before merging, I also want to give @tatica, @jonatoni, and @amsharma a chance to weigh in as past D&I Advisors, and for @riecatnor to review from the FCAIC point-of-view.

@nasirhm wrote:
I wonder if there's a way we can mirror the Council Page for D&I Advisor for it, What do you think ?

Yes. I plan to do two things after this PR is merged:

  1. Add a redirect to docs.fp.o site builder for council/diversity-advisor/ to diversity-inclusion/roles/council-advisor/
  2. Delete page in Council docs, change existing xref links in other Council docs pages to the new page location here

I think these two changes will be sufficient to avoid 404s for people with bookmarks or other hard-coded URLs on the Internet. The redirect will also help out with Search Engine Optimization and indexing.

I followed up for feedback in the IRC channel. Going to leave this open until Wednesday, 2 December. If no further feedback by then, I will merge it and work on the other pending actions listed in Fedora-Council/council-docs#96.

@jflory7 wrote:
Yes. I plan to do two things after this PR is merged:

  1. Add a redirect to docs.fp.o site builder for council/diversity-advisor/ to diversity-inclusion/roles/council-advisor/
  2. Delete page in Council docs, change existing xref links in other Council docs pages to the new page location here

I think these two changes will be sufficient to avoid 404s for people with bookmarks or other hard-coded URLs on the Internet. The redirect will also help out with Search Engine Optimization and indexing.

Sounds like an awesome plan @jflory7 , Thank you for working on it :D

It'll be a great move towards improving our documentation by using modules and for the future, once we will have other roles for the D&I Team. It'll be good to have a separate module for roles for better management.

Thanks @nasirhm!

Today is Thursday, 3 December. I am going to merge this Pull Request and follow up on the other pending actions to do a graceful migration from the Council docs to the D&I docs.

Merging. :ocean:

Pull-Request has been merged by jflory7

3 years ago

The docs for Fedora are failing to build with the following error:

error: Page alias cannot reference an existing page: master@diversity-inclusion:roles:council-advisor.adoc

Any chance it's related to this PR?

@dustymabe Thank you for letting us know, I'm taking a look at it.