From c924bfd1905269575ee4ab5b113861d030e422ae Mon Sep 17 00:00:00 2001 From: Justin W. Flory Date: Mar 02 2020 18:24:34 +0000 Subject: [PATCH 1/3] 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/docs/modules/ROOT/nav.adoc b/docs/modules/ROOT/nav.adoc index 29f4292..9b0e2fa 100644 --- a/docs/modules/ROOT/nav.adoc +++ b/docs/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/docs/modules/ROOT/pages/join.adoc b/docs/modules/ROOT/pages/join.adoc new file mode 100644 index 0000000..0763c2d --- /dev/null +++ b/docs/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. From f5355834d687be4caded3a1ca9296149dd13efb8 Mon Sep 17 00:00:00 2001 From: Justin W. Flory Date: Mar 02 2020 18:27:34 +0000 Subject: [PATCH 2/3] docs: Update YEAR attribute to 2020 New year, new decade! Awwww yisssss. Signed-off-by: Justin W. Flory --- diff --git a/docs/modules/ROOT/pages/_partials/attributes.adoc b/docs/modules/ROOT/pages/_partials/attributes.adoc index 09889ec..80f9545 100644 --- a/docs/modules/ROOT/pages/_partials/attributes.adoc +++ b/docs/modules/ROOT/pages/_partials/attributes.adoc @@ -3,4 +3,4 @@ :COMMBLOG: https://communityblog.fedoraproject.org :FEDMSG: http://www.fedmsg.com/ :FWIKI: https://fedoraproject.org/wiki -:YEAR: 2019 +:YEAR: 2020 From 46d284de3c929c190a363c6a00e2ad1ebc564622 Mon Sep 17 00:00:00 2001 From: Justin W. Flory Date: Mar 02 2020 18:31:38 +0000 Subject: [PATCH 3/3] README: Add link to new docs page on joining Badges This commit adds a link to the Fedora Docs page on joining the Fedora Badges community, which will be published within 1-2 hours of this commit merging to the `master` branch. Signed-off-by: Justin W. Flory --- diff --git a/README.md b/README.md index f639ae2..b59b753 100644 --- a/README.md +++ b/README.md @@ -24,6 +24,9 @@ Here, you can… * 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?