#139 Add "Make your first steps in Fedora" to CommOps docs
Merged 2 years ago by bex. Opened 2 years ago by jflory7.

file modified
+9 -7

@@ -21,13 +21,15 @@ 

  # The ordering of the records in this document determines the ordering of the

  # topic groups and topics on the main page.

  ---

- Name:  Fedora Information Guide

- Dir: en-US

+ Name:  Fedora Community Operations (CommOps)

+ Dir: docs

  Topics:

-   - Name: Book Information

+   - Name: About CommOps

      File: index

-   - Name: Installing Fedora

-     Dir: install

+   - Name: How to contribute

+     Dir: contribute

      Topics: 

-       - Name: Preparing for Installation

-         File: Preparing_for_Installation

+       - Name: Join CommOps

+         File: join

+       - Name: Make first steps

+         File: first-steps

@@ -0,0 +1,119 @@ 

+ include::docs/entities.adoc[]

+ 

+ = Make your first steps in Fedora

+ 

+ Are you new to the Fedora community?

+ Not sure where to start?

+ Learn how to make your 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 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 lists some of the best Fedora Badges to earn when you're getting started.

+ You may be able to earn more 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 to find good meeting times.

+ 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 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's longer than seven days, ask for help in irc://irc.freenode.org/#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.

+ 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 irc://irc.freenode.net/#fedora-commops[#fedora-commops] on Freenode'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/junior-tagger-tagger-i[Junior Tagger]

+ * https://badges.fedoraproject.org/badge/junior-package-tagger-package-tagger-i[Junior Package Tagger]

+ * 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!]

file added
+2

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

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

+ :YEAR: 2018

email-templates/elections/2016/interview-council-2016-template.html templates/elections/2016/interview-council-2016-template.html
file renamed
file was moved with no change to the file
email-templates/elections/2016/interview-famsco-2016-template.html templates/elections/2016/interview-famsco-2016-template.html
file renamed
file was moved with no change to the file
email-templates/elections/2016/interview-fesco-2016-template.html templates/elections/2016/interview-fesco-2016-template.html
file renamed
file was moved with no change to the file
email-templates/elections/2017/08/interview-council-august-2017.html templates/elections/2017/08/interview-council-august-2017.html
file renamed
file was moved with no change to the file
email-templates/elections/2017/08/interview-famsco-august-2017.html templates/elections/2017/08/interview-famsco-august-2017.html
file renamed
file was moved with no change to the file
email-templates/elections/2017/08/interview-fesco-august-2017.html templates/elections/2017/08/interview-fesco-august-2017.html
file renamed
file was moved with no change to the file
email-templates/elections/interview-council-template.html templates/elections/interview-council-template.html
file renamed
file was moved with no change to the file
email-templates/elections/interview-famsco-template.html templates/elections/interview-famsco-template.html
file renamed
file was moved with no change to the file
email-templates/elections/interview-fesco-template.html templates/elections/interview-fesco-template.html
file renamed
file was moved with no change to the file
email-templates/fas-applications/commops-application-removal.md templates/fas-applications/commops-application-removal.md
file renamed
file was moved with no change to the file
email-templates/fas-applications/magazine-application-removal.md templates/fas-applications/magazine-application-removal.md
file renamed
file was moved with no change to the file
email-templates/fas-applications/marketing-application-removal.md templates/fas-applications/marketing-application-removal.md
file renamed
file was moved with no change to the file

This PR does a few things:

  • Updates templates/ to email-templates/ to be more specific
    • Several quick email templates are saved here for elections and FAS applications
  • Adds an entities file (for variables we can use in any AsciiDoc in this repo)
  • Add Make your first steps in Fedora article
    • Takes inspiration from fedora-badges#409
    • Best badges we recommend to our newcomers earn before joining CommOps

Pull-Request has been merged by bex

2 years ago
Metadata
Changes Summary 15
+9 -7
file changed
_topic_map.yml
+119
file added
docs/contribute/first-steps.adoc
+2
file added
docs/entities.adoc
+0 -0
file renamed
templates/elections/2016/interview-council-2016-template.html
email-templates/elections/2016/interview-council-2016-template.html
+0 -0
file renamed
templates/elections/2016/interview-famsco-2016-template.html
email-templates/elections/2016/interview-famsco-2016-template.html
+0 -0
file renamed
templates/elections/2016/interview-fesco-2016-template.html
email-templates/elections/2016/interview-fesco-2016-template.html
+0 -0
file renamed
templates/elections/2017/08/interview-council-august-2017.html
email-templates/elections/2017/08/interview-council-august-2017.html
+0 -0
file renamed
templates/elections/2017/08/interview-famsco-august-2017.html
email-templates/elections/2017/08/interview-famsco-august-2017.html
+0 -0
file renamed
templates/elections/2017/08/interview-fesco-august-2017.html
email-templates/elections/2017/08/interview-fesco-august-2017.html
+0 -0
file renamed
templates/elections/interview-council-template.html
email-templates/elections/interview-council-template.html
+0 -0
file renamed
templates/elections/interview-famsco-template.html
email-templates/elections/interview-famsco-template.html
+0 -0
file renamed
templates/elections/interview-fesco-template.html
email-templates/elections/interview-fesco-template.html
+0 -0
file renamed
templates/fas-applications/commops-application-removal.md
email-templates/fas-applications/commops-application-removal.md
+0 -0
file renamed
templates/fas-applications/magazine-application-removal.md
email-templates/fas-applications/magazine-application-removal.md
+0 -0
file renamed
templates/fas-applications/marketing-application-removal.md
email-templates/fas-applications/marketing-application-removal.md