fedora-diversity

#110 docs: Refactor/rewrite of "Get involved" page
Merged by jflory7. Opened by jflory7.
jflory7/fedora-diversity change/join-docs  into  master

Download 110.patch

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)

Metadata Update from @jflory7:
- Pull-request tagged with: improvement, type - docs, type - onboarding

Here is a screenshot of the rendered change on my local workstation. Note the CommOps page will not render because I only built the Fedora D&I team docs, not the whole Fedora Docs site:

Screenshot of the updated "Get involved" page from a browser on my own laptop

Why make your first step is pointing to commops page?

Why make your first step is pointing to commops page?

It links to this page:

https://docs.fedoraproject.org/en-US/commops/contribute/first-steps/

This page suggests good beginner Fedora Badges for someone to earn, for any team or sub-project. Since it was already written there, I thought it was better to link to the existing page instead of duplicating content.

Why make your first step is pointing to commops page?

It links to this page:
https://docs.fedoraproject.org/en-US/commops/contribute/first-steps/
This page suggests good beginner Fedora Badges for someone to earn, for any team or sub-project. Since it was already written there, I thought it was better to link to the existing page instead of duplicating content.

Ok great. I am +1 for the change.
At the sametime, do you think if this page is generic than there can be a better place for this page, more visible?

+1, thanks for the changes @jflory7

At the sametime, do you think if this page is generic than there can be a better place for this page, more visible?

Getting it into the Mindshare docs could be interesting. I think the CommOps team is re-discovering their purpose at the moment though.

I'm going to go ahead and merge this PR for now. :clapper:

Pull-Request has been merged by jflory7
Metadata
None

improvement type - docs type - onboarding

Static archive. pagure.io was sunset in 2026; this is a read-only snapshot.
Red Hat Logo

Fedora is sponsored by Red Hat. Learn more about the relationship between Red Hat and Fedora »

© Red Hat, Inc. and others.