From 68d650682d51d5fcb0103b4e6dbd69ab1a4c41d3 Mon Sep 17 00:00:00 2001 From: Justin W. Flory (he/him) [Fedora Project] Date: Aug 06 2021 17:53:34 +0000 Subject: outreach-badges: Add initial content to Community Outreach Badges module This commit adds @dhairya15's contributions during the Docs Revamp hackfest at Nest 2021 into a published module. I also moved the existing "First steps" page already published in the CommOps docs into this module as well. This completes this module and gives us something to continue building on over time. CC: @asamalik @riecatnor for reviewing/merging Signed-off-by: Justin W. Flory (he/him) [Fedora Project] --- diff --git a/docs/antora.yml b/docs/antora.yml index 6f07b26..3ca1c54 100644 --- a/docs/antora.yml +++ b/docs/antora.yml @@ -16,3 +16,4 @@ nav: - modules/ROOT/nav.adoc - modules/teams/nav.adoc - modules/handbooks/nav.adoc + - modules/outreach-badges/nav.adoc diff --git a/docs/modules/ROOT/nav.adoc b/docs/modules/ROOT/nav.adoc index 836702c..15a043d 100644 --- a/docs/modules/ROOT/nav.adoc +++ b/docs/modules/ROOT/nav.adoc @@ -1,6 +1,5 @@ * How to contribute ** xref:contribute/join.adoc[Join CommOps] -** xref:contribute/first-steps.adoc[Make first steps] ** xref:contribute/successful-contributor.adoc[How to be a successful contributor] * xref:appreciation-week.adoc[Appreciation Week] * xref:community-blog.adoc[Community Blog] diff --git a/docs/modules/ROOT/pages/contribute/first-steps.adoc b/docs/modules/ROOT/pages/contribute/first-steps.adoc deleted file mode 100644 index 2267281..0000000 --- a/docs/modules/ROOT/pages/contribute/first-steps.adoc +++ /dev/null @@ -1,117 +0,0 @@ -include::ROOT:partial$attributes.adoc[] - -= Make your first steps in Fedora - -Are you new to the Fedora community? -Not sure where to start? -Learn how to make the first steps in the Fedora community by earning these Fedora Badges. - - -[[fedora-badges]] -== What are Fedora Badges? - -Fedora Badges are a fun way to earn virtual badges for doing helpful things in the Fedora community. -There are hundreds of badges to earn for different types of activities. -Some badges are for technical tasks while others are for non-technical tasks. -To learn more about Fedora Badges, https://badges.fedoraproject.org/about[read the website] for more info. - -This page suggests the best Fedora Badges to earn when you are getting started. -You may be able to earn other badges too! -But if you aren't sure where to start, begin with these ones. - - -[[involvement]] -== Involvement - -https://badges.fedoraproject.org/badge/involvement[Involvement] is awarded when you sign the https://fedoraproject.org/wiki/Legal:Fedora_Project_Contributor_Agreement[Fedora Project Contributor Agreement] (FPCA). -To sign the FPCA, do this from the https://admin.fedoraproject.org/accounts/[Fedora Account System] (FAS). - -image::https://badges.fedoraproject.org/pngs/involvement.png[Involvement - Fedora Badges] - - -[[white-rabbit]] -== White Rabbit - -https://badges.fedoraproject.org/badge/white-rabbit[White Rabbit] is awarded when you set your time zone in your Fedora Account System (FAS) account. -Some tools in Fedora will display your time zone or what your current local time is. -This is helpful so others know when you may be around or not to disturb you. -To set your time zone in FAS, follow these steps: - -. Go to https://admin.fedoraproject.org/accounts/[Fedora Account System] -. Select _Login_ in the top-right corner -. Login with username and password -. Select _My Account_ on menu at the top -. Select _Edit_ on the _Your Fedora Account_ page -. Change the _Time Zone_ field to your current time zone -. Select _Save_ - -This badge is not awarded immediately. You should receive it in a few days of updating your time zone. - -image::https://badges.fedoraproject.org/pngs/fas-white-rabbit.png[White Rabbit - Fedora Badges] - - -[[crypto-badger]] -== Crypto Badger - -https://badges.fedoraproject.org/badge/crypto-badger[Crypto Badger] is awarded when you add an SSH key to your Fedora Account System (FAS) account. -You may or may not have an SSH key already. -If you do, you can add it from a macOS/UNIX/Linux system to your FAS account with these steps: - -. Generate SSH key using `ssh-keygen` -.. If you use defaults, this generates a `~/.ssh/id_rsa` private key file and a `~/.ssh/id_rsa.pub` public key file -. Go to https://admin.fedoraproject.org/accounts/[Fedora Account System] -. Select _Login_ in the top-right corner -. Login with username and password -. Select _My Account_ on menu at the top -. Select _Edit_ on the _Your Fedora Account_ page -. Upload `~/.ssh/id_rsa.pub` public key file you generated in first step -. Select _Save_ - -The badge is awarded once per week, so you may not get the badge immediately. -If it is longer than seven days, ask for help in https://libera.chat/#fedora-admin[#fedora-admin] on IRC. - -image::https://badges.fedoraproject.org/pngs/fas-crypto-badger.png[Crypto Badger - Fedora Badges] - - -[[crypto-panda]] -== Crypto Panda - -https://badges.fedoraproject.org/badge/crypto-panda[Crypto Panda] is awarded when you add a GPG public key to your Fedora Account System (FAS) account. -You may or may not have a GPG key already. -They are not required to participate. -If you want to generate one, read the https://fedoramagazine.org/gnupg-a-fedora-primer/[GPG series] on the Fedora Magazine. -If you have a GPG public key, upload it FAS with these steps: - -. Go to https://admin.fedoraproject.org/accounts/[Fedora Account System] -. Select _Login_ in the top-right corner -. Login with username and password -. Select _My Account_ on menu at the top -. Select _Edit_ on the _Your Fedora Account_ page -. Add the last 16 characters of your public key fingerprint file (e.g. `39E45FB6014131E4`) to _GPG Key ID_ -. Select _Save_ - -image::https://badges.fedoraproject.org/pngs/fas-crypto-panda.png[Crypto Panda - Fedora Badges] - - -[[baby-badger]] -== Baby Badger - -https://badges.fedoraproject.org/badge/baby-badger[Baby Badger] is awarded when you log into the Fedora Badges website for the first time. -To log into the Fedora Badges site, you need to register in the Fedora Account System (FAS). -After you have an account, https://badges.fedoraproject.org/login[log in] to the Badges application to earn this badge. - -image::https://badges.fedoraproject.org/pngs/baby-badger.png[Baby Badger - Fedora Badges] - - -== Other badges - -The badges listed here are also good badges to earn. -They aren't explained yet, but they will be soon. -If you want to help with this, come say hello in https://libera.chat/#fedora-commops[#fedora-commops] on Libera.chat's IRC network. - -* https://badges.fedoraproject.org/badge/bloggin-it!-planet-i[Bloggin' it!] -* https://badges.fedoraproject.org/badge/curious-penguin-ask-fedora-i[Curious Penguin] -* https://badges.fedoraproject.org/badge/macaron-cookie-i[Macaron - Cookie I] -* https://badges.fedoraproject.org/badge/mugshot[Mugshot] -* https://badges.fedoraproject.org/badge/origin[Origin] -* https://blog.justinwflory.com/2016/01/gotta-badge-em-all-speak-up/[Speak Up!] diff --git a/docs/modules/outreach-badges/nav.adoc b/docs/modules/outreach-badges/nav.adoc new file mode 100644 index 0000000..a7b2378 --- /dev/null +++ b/docs/modules/outreach-badges/nav.adoc @@ -0,0 +1,5 @@ +* *Community Outreach Badges* +** xref:first-steps.adoc[First steps] +** xref:events.adoc[Event Badges] +** xref:repos.adoc[Repo Badges] +** xref:team-members.adoc[Team Member Badges] diff --git a/docs/modules/outreach-badges/pages/events.adoc b/docs/modules/outreach-badges/pages/events.adoc index 974a87d..22531fd 100644 --- a/docs/modules/outreach-badges/pages/events.adoc +++ b/docs/modules/outreach-badges/pages/events.adoc @@ -1,3 +1,21 @@ include::ROOT:partial$attributes.adoc[] = Event Badges +Dhairya Chaudhary; Justin W. Flory; Fedora Community +:page-authors: {author}, {author_2}, {author_3} + + +== Event Organizer + +* *Discussion*: + https://pagure.io/fedora-badges/issue/830 +* *Description*: + For organizing a Fedora event and submitting a report to the Community Blog + + +== Panda Sighting + +* *Discussion*: + https://pagure.io/fedora-badges/issue/835 +* *Description*: + For featuring on Fedora’s YouTube account diff --git a/docs/modules/outreach-badges/pages/first-steps.adoc b/docs/modules/outreach-badges/pages/first-steps.adoc new file mode 100644 index 0000000..dc28ffa --- /dev/null +++ b/docs/modules/outreach-badges/pages/first-steps.adoc @@ -0,0 +1,119 @@ +include::ROOT:partial$attributes.adoc[] + += Make your first steps in Fedora +Justin W. Flory; Fedora Community +:page-authors: {author}, {author_2} + +Are you new to the Fedora community? +Not sure where to start? +Learn how to make the first steps in the Fedora community by earning these Fedora Badges. + + +[[fedora-badges]] +== What are Fedora Badges? + +Fedora Badges are a fun way to earn virtual badges for doing helpful things in the Fedora community. +There are hundreds of badges to earn for different types of activities. +Some badges are for technical tasks while others are for non-technical tasks. +To learn more about Fedora Badges, https://badges.fedoraproject.org/about[read the website] for more info. + +This page suggests the best Fedora Badges to earn when you are getting started. +You may be able to earn other badges too! +But if you aren't sure where to start, begin with these ones. + + +[[involvement]] +== Involvement + +https://badges.fedoraproject.org/badge/involvement[Involvement] is awarded when you sign the https://fedoraproject.org/wiki/Legal:Fedora_Project_Contributor_Agreement[Fedora Project Contributor Agreement] (FPCA). +To sign the FPCA, do this from the https://admin.fedoraproject.org/accounts/[Fedora Account System] (FAS). + +image::https://badges.fedoraproject.org/pngs/involvement.png[Involvement - Fedora Badges] + + +[[white-rabbit]] +== White Rabbit + +https://badges.fedoraproject.org/badge/white-rabbit[White Rabbit] is awarded when you set your time zone in your Fedora Account System (FAS) account. +Some tools in Fedora will display your time zone or what your current local time is. +This is helpful so others know when you may be around or not to disturb you. +To set your time zone in FAS, follow these steps: + +. Go to https://admin.fedoraproject.org/accounts/[Fedora Account System] +. Select _Login_ in the top-right corner +. Login with username and password +. Select _My Account_ on menu at the top +. Select _Edit_ on the _Your Fedora Account_ page +. Change the _Time Zone_ field to your current time zone +. Select _Save_ + +This badge is not awarded immediately. You should receive it in a few days of updating your time zone. + +image::https://badges.fedoraproject.org/pngs/fas-white-rabbit.png[White Rabbit - Fedora Badges] + + +[[crypto-badger]] +== Crypto Badger + +https://badges.fedoraproject.org/badge/crypto-badger[Crypto Badger] is awarded when you add an SSH key to your Fedora Account System (FAS) account. +You may or may not have an SSH key already. +If you do, you can add it from a macOS/UNIX/Linux system to your FAS account with these steps: + +. Generate SSH key using `ssh-keygen` +.. If you use defaults, this generates a `~/.ssh/id_rsa` private key file and a `~/.ssh/id_rsa.pub` public key file +. Go to https://admin.fedoraproject.org/accounts/[Fedora Account System] +. Select _Login_ in the top-right corner +. Login with username and password +. Select _My Account_ on menu at the top +. Select _Edit_ on the _Your Fedora Account_ page +. Upload `~/.ssh/id_rsa.pub` public key file you generated in first step +. Select _Save_ + +The badge is awarded once per week, so you may not get the badge immediately. +If it is longer than seven days, ask for help in https://libera.chat/#fedora-admin[#fedora-admin] on IRC. + +image::https://badges.fedoraproject.org/pngs/fas-crypto-badger.png[Crypto Badger - Fedora Badges] + + +[[crypto-panda]] +== Crypto Panda + +https://badges.fedoraproject.org/badge/crypto-panda[Crypto Panda] is awarded when you add a GPG public key to your Fedora Account System (FAS) account. +You may or may not have a GPG key already. +They are not required to participate. +If you want to generate one, read the https://fedoramagazine.org/gnupg-a-fedora-primer/[GPG series] on the Fedora Magazine. +If you have a GPG public key, upload it FAS with these steps: + +. Go to https://admin.fedoraproject.org/accounts/[Fedora Account System] +. Select _Login_ in the top-right corner +. Login with username and password +. Select _My Account_ on menu at the top +. Select _Edit_ on the _Your Fedora Account_ page +. Add the last 16 characters of your public key fingerprint file (e.g. `39E45FB6014131E4`) to _GPG Key ID_ +. Select _Save_ + +image::https://badges.fedoraproject.org/pngs/fas-crypto-panda.png[Crypto Panda - Fedora Badges] + + +[[baby-badger]] +== Baby Badger + +https://badges.fedoraproject.org/badge/baby-badger[Baby Badger] is awarded when you log into the Fedora Badges website for the first time. +To log into the Fedora Badges site, you need to register in the Fedora Account System (FAS). +After you have an account, https://badges.fedoraproject.org/login[log in] to the Badges application to earn this badge. + +image::https://badges.fedoraproject.org/pngs/baby-badger.png[Baby Badger - Fedora Badges] + + +== Other badges + +The badges listed here are also good badges to earn. +They aren't explained yet, but they will be soon. +If you want to help with this, come say hello in https://libera.chat/#fedora-commops[#fedora-commops] on Libera.chat's IRC network. + +* https://badges.fedoraproject.org/badge/bloggin-it!-planet-i[Bloggin' it!] +* https://badges.fedoraproject.org/badge/curious-penguin-ask-fedora-i[Curious Penguin] +* https://badges.fedoraproject.org/badge/macaron-cookie-i[Macaron - Cookie I] +* https://badges.fedoraproject.org/badge/mugshot[Mugshot] +* https://badges.fedoraproject.org/badge/origin[Origin] +* https://blog.justinwflory.com/2016/01/gotta-badge-em-all-speak-up/[Speak Up!] diff --git a/docs/modules/outreach-badges/pages/repos.adoc b/docs/modules/outreach-badges/pages/repos.adoc new file mode 100644 index 0000000..11a63be --- /dev/null +++ b/docs/modules/outreach-badges/pages/repos.adoc @@ -0,0 +1,46 @@ +include::ROOT:partial$attributes.adoc[] + += Repo Badges +Dhairya Chaudhary; Justin W. Flory; Fedora Community +:page-authors: {author}, {author_2}, {author_3} + + +== CommOps Busy Bee + +* *Discussion*: + https://pagure.io/fedora-badges/issue/831 +* *Description*: + For opening a ticket on the CommOps repo + + +== The Bee's Knees + +* *Discussion*: + https://pagure.io/fedora-badges/issue/832 +* *Description*: + For closing a ticket on the CommOps repo + + +== Onboarding Ideas Specialist + +* *Discussion*: + https://pagure.io/fedora-badges/issue/836 +* *Description*: + For opening a ticket on the Fedora Join SIG pagure repo + + +== Onboarding Specialist + +* *Discussion*: + https://pagure.io/fedora-badges/issue/837 +* *Description*: + For closing a ticket on the Fedora Join SIG pagure repo + + +== Welcoming Committee + +* *Discussion*: + https://pagure.io/fedora-badges/issue/834 +* *Description*: + For closing tickets in the Welcome-to-Fedora pagure repo + (Earned for 1, 5, 10, 25, 50, and 100 ticket landmarks) diff --git a/docs/modules/outreach-badges/pages/team-members.adoc b/docs/modules/outreach-badges/pages/team-members.adoc index 9c95913..2b14782 100644 --- a/docs/modules/outreach-badges/pages/team-members.adoc +++ b/docs/modules/outreach-badges/pages/team-members.adoc @@ -1,3 +1,23 @@ include::ROOT:partial$attributes.adoc[] = Team Member Badges +Dhairya Chaudhary; Justin W. Flory; Fedora Community +:page-authors: {author}, {author_2}, {author_3} + +These badges are earned for becoming a member of a team, working group, or special interest group in the Fedora Community. + + +== Called to Action + +* *Discussion*: + https://pagure.io/fedora-badges/issue/833 +* *Description*: + For being a member of the marketing team + + +== Join SIG Membership Badge + +* *Discussion*: + https://pagure.io/fedora-badges/issue/736 +* *Description*: + For being a part of the Join SIG diff --git a/docs/modules/outreach-badges/repos.adoc b/docs/modules/outreach-badges/repos.adoc deleted file mode 100644 index 36b18f6..0000000 --- a/docs/modules/outreach-badges/repos.adoc +++ /dev/null @@ -1,3 +0,0 @@ -include::ROOT:partial$attributes.adoc[] - -= Repo Badges diff --git a/site.yml b/site.yml index 997c4ea..d810e21 100644 --- a/site.yml +++ b/site.yml @@ -1,5 +1,5 @@ -site: - title: Local Preview +site: + title: Fedora CommOps (local preview) start_page: commops::index content: sources: @@ -11,11 +11,11 @@ ui: url: https://asamalik.fedorapeople.org/ui-bundle.zip snapshot: true default_layout: with_menu -output: - clean: true +output: + clean: true dir: ./public - destinations: - - provider: archive + destinations: + - provider: archive runtime: pull: true cache_dir: ./cache