From 3bd6900957ac541ffcab260f522526cde3e7d27c Mon Sep 17 00:00:00 2001 From: siddharthvipul Date: May 13 2022 10:34:42 +0000 Subject: add first page in welcome section (transfer from FCOR objective doc) Signed-off-by: siddharthvipul --- diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index 3385a8d..e223efd 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -1,4 +1,6 @@ -* xref:welcome/welcome.adoc[Welcome!] +* Welcome! +** xref:welcome/welcome.adoc[Welcome to Fedora!] +** xref:welcome/first-steps.adoc[First steps] * Classroom ** xref:classroom/classroom.adoc[Classroom] diff --git a/modules/ROOT/pages/welcome/first-steps.adoc b/modules/ROOT/pages/welcome/first-steps.adoc new file mode 100644 index 0000000..3316895 --- /dev/null +++ b/modules/ROOT/pages/welcome/first-steps.adoc @@ -0,0 +1,121 @@ +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, link: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 + +link:https://badges.fedoraproject.org/badge/involvement[Involvement] is awarded when you sign the link:https://fedoraproject.org/wiki/Legal:Fedora_Project_Contributor_Agreement[Fedora Project Contributor Agreement] (FPCA). +To sign the FPCA, do this from the link:https://accounts.fedoraproject.org/[Fedora Account System] (FAS). + +image::https://badges.fedoraproject.org/pngs/involvement.png[Involvement - Fedora Badges] + + +[[white-rabbit]] +== White Rabbit + +link: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 link:https://accounts.fedoraproject.org/[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 + +link: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 link:https://accounts.fedoraproject.org/[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 +. Go to tab _SSH & GPG Keys_ +. 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 link: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 + +link: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 link: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 link:https://accounts.fedoraproject.org/[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 +. Go to tab _SSH & GPG Keys_ +. 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 + +link: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, link: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 link:https://libera.chat/#fedora-commops[#fedora-commops] on Libera.chat's IRC network. + +* link:https://badges.fedoraproject.org/badge/bloggin-it!-planet-i[Bloggin' it!] +* link:https://badges.fedoraproject.org/badge/curious-penguin-ask-fedora-i[Curious Penguin] +* link:https://badges.fedoraproject.org/badge/macaron-cookie-i[Macaron - Cookie I] +* link:https://badges.fedoraproject.org/badge/mugshot[Mugshot] +* link:https://badges.fedoraproject.org/badge/origin[Origin] +* link:https://blog.justinwflory.com/2016/01/gotta-badge-em-all-speak-up/[Speak Up!]