From d072cb02b0042190ba990dc0c4061e74bceda41c Mon Sep 17 00:00:00 2001 From: Justin W. Flory Date: Mar 02 2020 18:24:34 +0000 Subject: docs: Initial commit on how to join Badges community 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/ Signed-off-by: Justin W. Flory --- diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index 29f4292..9b0e2fa 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -1 +1,2 @@ * xref:design-badges.adoc[How to design a Fedora Badge] +* xref:join.adoc[Join Badges community] diff --git a/modules/ROOT/pages/join.adoc b/modules/ROOT/pages/join.adoc new file mode 100644 index 0000000..0763c2d --- /dev/null +++ b/modules/ROOT/pages/join.adoc @@ -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.