From b1633f7aaa2d3f98761a7409ebcf9f48c23aaab7 Mon Sep 17 00:00:00 2001 From: Justin W. Flory Date: Jul 09 2019 02:25:48 +0000 Subject: docs: Refactor/rewrite of "Get involved" page This commit is a significant rewrite of our "Get involved" page. I expanded some parts, rewrote some parts to be more clear, fixed a lot of URLs, and removed some parts that are not a major part of actually getting involved as a team member. My edits are briefly explained below: * Create FAS account: Fix links, try to better explain why this is important/necessary * Wiki homepage: Realistically the wiki homepage is not critical and there are new barriers to editing the wiki because of anti-spam measures (CLA+1 required) * Mailing list: Better explain how we use our mailing list * Self-introduction: Attempted to make questions feel more genuinely curious - they felt a little intimidating to me in retrospect! * Group chat: Properly explain IRC/Telegram, add links to join either * First steps: Fix `xref` to CommOps docs * Meetings: Better explain how our meetings work as of 2019 * Pagure tickets: Clarify our workflow for 2019, update/fix URLs, and emphasize importance of new ideas into the mix too :) * FAS group: Drop this completely, it is not a major part of our everyday work and the group is invite-only now anyways (i.e. nobody can join the group on their own anymore) --- diff --git a/modules/ROOT/pages/get-involved.adoc b/modules/ROOT/pages/get-involved.adoc index 4b78122..6461bad 100644 --- a/modules/ROOT/pages/get-involved.adoc +++ b/modules/ROOT/pages/get-involved.adoc @@ -1,96 +1,107 @@ -= Join Fedora Diversity and Inclusion Team += Get involved with Fedora Diversity and Inclusion Team -If you're interested in helping with the Fedora Diversity and Inclusion Team, please complete the following steps to become a member. +Interested in helping the Fedora Diversity and Inclusion Team? +This page explains the typical process for getting involved with our team. [[create-fas-account]] -== Create an FAS account +== Create Fedora Account System (FAS) account -In order to contribute to Fedora, you will need to create a link:Account_System[FAS account] and sign the Legal:Fedora_Project_Contributor_Agreement[Fedora Project Contributor Agreement], if you have not already. -You can do this through the link:Infrastructure/AccountSystem[Fedora Account System]. - - -[[update-wiki]] -== Update your wiki homepage - -Use your link:Account_System[Account System] to login and start adding content to your homepage. -It's recommended you put some of your activity or involvement, inside or outside of Fedora, on this page. -It's helpful for others to know more about you, what you are involved with in the project, and more. +All contributors to Fedora need to register in the https://admin.fedoraproject.org/accounts/[Fedora Account System]. +New contributors are asked to sign the https://fedoraproject.org/wiki/Legal:Fedora_Project_Contributor_Agreement[Fedora Project Contributor Agreement] (FPCA). +This is not a copyright assignment agreement, but ensures your contributions to Fedora have acceptable licensing terms. +If you need help with this, contact the https://fedoraproject.org/wiki/Infrastructure#Communicating[Fedora Infrastructure Team]. [[mailing-list]] == Join the mailing list -To join the mailing list, you must subscribe on https://lists.fedoraproject.org/admin/lists/diversity.lists.fedoraproject.org[lists.fedoraproject.org]. -Our mailing list is a key part of how Diversity communicates, and a lot of important news and discussion are shared through our mailing list. +https://lists.fedoraproject.org/admin/lists/diversity.lists.fedoraproject.org[**Subscribe here!**] + +The Fedora Diversity and Inclusion Team uses a mailing list. +The mailing list is used for announcements, summaries of meetings, and a way to share longer-form content with the team. +It is a good place to keep up with what we are up to! +To join the mailing list, subscribe on https://lists.fedoraproject.org/admin/lists/diversity.lists.fedoraproject.org[lists.fedoraproject.org]. [[self-introduction]] == Send a self-introduction -Send a self-introduction to the mailto:diversity@lists.fedoraproject.org[Diversity mailing list] explaining a bit about yourself. -This is one of the most helpful steps for the rest of the Diversity and Inclusion Team members. -When introducing yourself, here's some key points to make sure to include in your introduction: +If you want to get involved, we want to get to know you! +So don't be shy, send an introduction on our mailing list. +This is a helpful step for other folks on the team to get to know you. + +Not sure what to say? +Does writing an introduction feel awkward? +Consider these questions when introducing yourself: -* Are you new to contributing to Fedora? - If so, tell us why you're interested in contributing or what interests you most. -* Are you from another community? - Tell us about your role and what you're doing in those other communities. -* Already an active contributor? - Share what other areas of Fedora you are working in and your role in the Project. -* Involved with any local events or programs? - If you do any in-person advocacy for Linux, Fedora, or diversity in tech, tell us about how you're involved. - (Also consider adding your event to the link:Diversity_Events[Diversity Events] wiki page!) -* What interests you in the Diversity and Inclusion Team? - What are your interests for wanting to become involved or what motivates you up to want to participate? +* Are you new to the Fedora community? + If so, what was interesting to you about Fedora? +* Are you involved with other communities? + Tell us about what you do in other communities or projects. +* Do you already contribute to Fedora? + Let us know what parts of Fedora you are involved in. +* Are you an organizer of local events or programs? + If you run any kind of event in your local community, let us know what you do. +* What is interesting to you about the Fedora Diversity and Inclusion Team? + Our team is a collection of people with different interests and niches. + Knowing each others' interests and what we like lets us connect each other to things we want to help out with. [[join-irc-telegram]] -== Join #fedora-diversity on IRC or Telegram +== Join IRC/Telegram group chat -Your next step should be to join the https://webchat.freenode.net/?channels=#fedora-diversity[#fedora-diversity] IRC channel on the FreeNode IRC network. -A lot of our discussion and planning happens in real-time on IRC, and it's the best place to meet some of the team and get a view of what's happening with the Diversity and Inclusion Team. +The Fedora Diversity and Inclusion Team has a real-time group chat. +We use this group chat for quick updates, friendly chatter, and running meetings. +We use both an IRC channel on the https://freenode.net/[Freenode IRC network] and a Telegram chat group. +Both are bridged to each other, so folks in IRC will see Telegram messages and vice versa. + +Here are the easiest ways to join: + +* IRC +** link:ircs://chat.freenode.net:6697/%23fedora-diversity[`chat.freenode.net/#fedora-diversity`] +** https://webchat.freenode.net/?channels=#fedora-diversity[Web chat] +* https://t.me/fedoradiversity[Telegram] + +Don't forget to say hi when you join! [[first-steps]] == Make your first steps -See xref:commops::first-steps.adoc[Make your first steps in Fedora] for more info. +See xref:commops::contribute/first-steps.adoc[Make your first steps in Fedora] for more info. [[attend-meeting]] == Attend a meeting -A lot of action happens at the https://apps.fedoraproject.org/calendar/diversity-team/[bi-monthly meetings]. -Attend a Fedora https://apps.fedoraproject.org/calendar/diversity-team/[Diversity and Inclusion Team meeting] and introduce yourself during roll call! - -Every week, the Diversity and Inclusion team comes together to discuss https://pagure.io/fedora-diversity/issues?tags=meeting[items on our agenda] and check in on the tasks that everyone is working on. -Introducing yourself during roll call is another great way to get involved and will let others know you are part of the meeting. - +https://apps.fedoraproject.org/calendar/diversity-team/[**Find our next meeting on our calendar!**] -[[get-your-hands-dirty]] -== Get your hands dirty +The team usually holds a weekly meeting over IRC/Telegram to review on-going work and determine next steps on current work. +The meeting format is intended to be quick updates instead of long discussion. +It is a good opportunity to say hello and meet other members of the team in real-time. -Now, you should begin finding a task to work on. -All Diversity-related tasks are mapped out in our https://pagure.io/fedora-diversity/issues[Pagure repository]. -Tasks, problems, or objectives are added as "issues" to the https://pagure.io/fedora-diversity/issues[fedora-diversity repository on -Pagure]. -Check and see https://pagure.io/fedora-diversity/issues?tags=meeting[what D&I is working on now] to see what is happening this week. +[[tickets]] +== Check out Pagure tickets -After that, look at all of the https://pagure.io/fedora-diversity/issues[open tickets] on our https://pagure.io/fedora-diversity/[Pagure repository]. -See something that looks interesting? -Be sure to leave a comment and feedback if possible. -Check if the ticket has an owner. -If it doesn't, you can step up and take ownership! -If it does, contact the owner of the ticket and see if they need any help. -This also provides a great opportunity to get mentorship and help with getting started on a new task! +The next step to get involved is to review our ticket tracker and look for something interesting to you. +All of our open tickets are in our https://pagure.io/fedora-diversity/issues[Pagure repository]. +New tasks are added as "issues" into the Pagure repository. +Here is a quick index of different types of tickets: -[[join-fas-group]] -== Join the FAS group +* https://pagure.io/fedora-diversity/issues?status=Open&priority=20[Meeting tickets] +* https://pagure.io/fedora-diversity/issues?status=Open&tags=good+first+issue[Good first tickets for newcomers] +* https://pagure.io/fedora-diversity/roadmap[Roadmap] (collection of tickets around specific objectives or goals) -After completing or beginning *all* of the above steps, you can apply for membership in the https://admin.fedoraproject.org/accounts/group/view/diversity-team[Diversity and Inclusion Team FAS group]. +See a ticket that looks interesting? +If someone is not already assigned, leave a comment and ask how you can help. +Another member of the team will get back to you with some feedback on how you get help. +This is one opportunity to get mentorship and help with getting started on a task. -In the beginning of your time contributing, you will remain pending in the group. -After staying involved with Diversity for a while and helping out with tasks, your membership will be approved. +Alternatively, do you think something is missing or could be improved in the Fedora community? +Open a new ticket with your idea or suggestion. +Our best ideas come from a wide range of people with different backgrounds, experiences, and perspectives. +Whether you are new to the Fedora community or are a long-time contributor, you might have the next great idea for the team. +Open a new ticket and we can discuss more about your idea or suggestion.