#718 docs: Initial commit on how to join Badges community
Merged 2 years ago by laxathom. Opened 2 years ago by jflory7.

file modified
+3
@@ -24,6 +24,9 @@ 

  * Contribute badge designs and artwork

  * Add or change documentation on [docs.fedoraproject.org/en-US/badges/](https://docs.fedoraproject.org/en-US/badges/ "Fedora Badges :: Fedora Docs")

  

+ ### How do I get involved with the Fedora Badges community?

+ 

+ See [Join Fedora Badges community](https://docs.fedoraproject.org/en-US/badges/join/) in our docs for more info.

  

  ### How do I design new badges?

  

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

  * xref:design-badges.adoc[How to design a Fedora Badge]

+ * xref:join.adoc[Join Badges community]

@@ -3,4 +3,4 @@ 

  :COMMBLOG: https://communityblog.fedoraproject.org

  :FEDMSG: http://www.fedmsg.com/

  :FWIKI: https://fedoraproject.org/wiki

- :YEAR: 2019

+ :YEAR: 2020

@@ -0,0 +1,100 @@ 

+ include::{partialsdir}/attributes.adoc[]

+ 

+ = Join Fedora Badges community

+ 

+ Become a member of Fedora Badges community by following these steps.

+ 

+ 

+ [[fas]]

+ == Create a FAS account

+ 

+ Create a {FWIKI}/Account_System[Fedora Account System account] and sign the {FWIKI}/Legal:Fedora_Project_Contributor_Agreement[Fedora Project Contributor Agreement].

+ Do this through the https://admin.fedoraproject.org/accounts/[Fedora Account System].

+ 

+ 

+ [[discourse]]

+ == Subscribe to Fedora Badges mailing list

+ 

+ Log into the Fedora mailing lists site at https://lists.fedoraproject.org/accounts/login/?next=/admin/lists/badges.lists.fedoraproject.org/[lists.fedoraproject.org] using your FAS account credentials.

+ Then, find the https://lists.fedoraproject.org/admin/lists/badges.lists.fedoraproject.org/[Fedora Badges mailing list] and subscribe using your personal email address.

+ Do not use the `@fedoraproject.org` alias, as you are unable to send email from the address.

+ 

+ News, updates, and discussion are shared through on the mailing list.

+ It is a *key part* to how we communicate.

+ It receives low to medium traffic.

+ 

+ 

+ [[introduction]]

+ == Post a self-introduction

+ 

+ Say hello and introduce yourself to the team!

+ Post a self-introduction to the mailing list and tell us a little about yourself.

+ 

+ Not sure what to say?

+ Answer these questions to start:

+ 

+ * Why are you interested in contributing to Fedora?

+ * Why are you interested in contributing to Badges?

+ * If you're involved with other things in Fedora, what are/were you working on?

+ * Do you have any experience in open source or online communities?

+   If so, what?

+ * What parts of the Badges project are interesting to you?

+ * Do you have any questions for us?

+   How can we help _you_ get started?

+ 

+ 

+ [[community-blog]]

+ == Register on Community Blog

+ 

+ The Fedora {COMMBLOG}[Community Blog] is an important place for sharing news in the Fedora community.

+ An account gives permissions to view article drafts and previews before they are published.

+ If you ever write an article, you need an account.

+ To register, log in at the {COMMBLOG}/wp-login.php[login page] with your Fedora Account System (FAS) credentials.

+ 

+ Need more help logging in?

+ Read the {COMMBLOG}/how-to-log-in/[help page] for more detailed instructions.

+ 

+ 

+ [[irc-telegram]]

+ == Join our IRC/Telegram chat

+ 

+ Fedora uses the https://freenode.net[Freenode IRC network] and https://telegram.org/[Telegram] for instant messaging and communication.

+ You can use the messaging client of your choice, as the IRC channel and Telegram group are bridged together.

+ Short discussions and planning happen in our group chat.

+ 

+ Never used IRC before?

+ See the https://fedoramagazine.org/beginners-guide-irc/[Beginner's Guide to IRC] on the Fedora Magazine.

+ Additionally, you can connect temporarily in a chat session in your browser via https://webchat.freenode.net/?channels=fedora-badges[Freenode web chat].

+ However, if you want to stay connected even when you are not online, consider https://opensource.com/article/17/5/introducing-riot-IRC[using Riot] as your IRC client.

+ 

+ The IRC channel is also bridged to a Telegram group, https://t.me/fedorabadges[@fedorabadges].

+ Join the group at https://t.me/fedorabadges[t.me/fedorabadges].

+ 

+ 

+ [[first-steps]]

+ == Make your first steps

+ 

+ See xref:commops:contribute/first-steps.adoc[Make your first steps in Fedora] for more info.

+ 

+ 

+ [[start-task]]

+ == Start on a task

+ 

+ The Fedora Badges community tracks tasks and what we are working on in two places:

+ 

+ * Badges design: https://pagure.io/fedora-badges/issues[pagure.io/fedora-badges]

+ * Badges development: https://github.com/fedora-infra/badgr-server[github.com/fedora-infra/badgr-server]

+ 

+ Tasks, problems, and goals are filed as tickets in the issue trackers.

+ There are many tickets, but we're not working on everything at once.

+ Scrolling through the issue tracker gives a good idea of what the Badges community is doing.

+ 

+ // Look for the https://pagure.io/fedora-commops/issues?status=Open&tags=good+first+issue[good first issue] tag on tickets to find good tasks for beginners.

+ 

+ Does something look interesting?

+ Leave a comment on a ticket if you have a question or want to work on something.

+ Also check and see if the ticket is assigned to someone.

+ If it is unassigned, you can start on it.

+ If there is an assignee, ask them if they need help or if they are still working on the ticket.

+ 

+ This provides an opportunity to receive mentorship and get help to start a new task.

This commit creates a new page in our docs site about how to get
involved and join the Fedora Badges community. It includes some basic
instructions like how to register a FAS account, sign up to the mailing
list, join the IRC/Telegram, etc.

Once published, the page will be available here: https://docs.fedoraproject.org/en-US/badges/join/

Local preview of new docs page

1 new commit added

  • docs: Update YEAR attribute to 2020
2 years ago

Metadata Update from @jflory7:
- Pull-request tagged with: outreachy-2020, type - docs

2 years ago

1 new commit added

  • README: Add link to new docs page on joining Badges
2 years ago

Pull-Request has been merged by laxathom

2 years ago