| |
@@ -0,0 +1,91 @@
|
| |
+ include::docs/attributes.adoc[]
|
| |
+
|
| |
+ = Fedora Planet
|
| |
+
|
| |
+ {FPLANET} aggregates various Fedora-related blog posts by contributors in one place.
|
| |
+ Fedora contributors connect their https://en.wikipedia.org/wiki/Blog[blog] to the Planet and select specific posts to share on the Planet.
|
| |
+ Fedora Planet is a helpful way to see what is going on inside of the Fedora community from different points of view.
|
| |
+ It also expresses individual thoughts and personalities of the Fedora contributor community.
|
| |
+
|
| |
+
|
| |
+ [[add-blog-planet]]
|
| |
+ == Add your blog to Fedora Planet
|
| |
+
|
| |
+ To add your blog to {FPLANET}, you must meet these requirements:
|
| |
+
|
| |
+ * Sign the https://fedoraproject.org/wiki/Legal:Fedora_Project_Contributor_Agreement[Fedora Project Contributor Agreement] (FPCA)
|
| |
+ * _CLA+1_: Belong to one or more groups in FAS footnote:[https://admin.fedoraproject.org/accounts/[Fedora Account System]] other than the FPCA group
|
| |
+ * Add a public SSH key to FAS
|
| |
+
|
| |
+ After verifying you meet the requirements, set up a specific category or tag on your blog for Fedora-related content.
|
| |
+ This lets you filter specific content on your blog to share with the Fedora community.
|
| |
+ It is discouraged to add the feed for your entire blog to the Fedora Planet.
|
| |
+ Look up the documentation on how to create a feed for a category or tag for the blogging software you use.
|
| |
+
|
| |
+ This guide also assumes you are using Fedora or a Linux-based operating system.
|
| |
+ Follow these steps to add your blog to Fedora Planet:
|
| |
+
|
| |
+ In your preferred plain text text editor, create a file like this::
|
| |
+ ----
|
| |
+ [https://myblog.wordpress.com/category/fedora/feed/] # <1>
|
| |
+ name = Your Name # <2>
|
| |
+ face = https://example.com/profile-picture.jpg # <3>
|
| |
+ ----
|
| |
+ <1> *URL of your category-specific RSS/RSS2/Atom feed*, not your blog's URL
|
| |
+ <2> *Your name* as you want it to appear
|
| |
+ <3> Link to a *profile picture* to display alongside your posts on Fedora Planet
|
| |
+
|
| |
+ The file should have no spaces or tabs before any of the lines
|
| |
+ Also, you can have more than one entry in your `.planet` file.
|
| |
+ Add another one below in the same format.
|
| |
+
|
| |
+ Log into your {FWIKI}/Infrastructure/fedorapeople.org[fedorapeople.org] account (your account is created on first login)::
|
| |
+ [source,bash]
|
| |
+ ----
|
| |
+ ssh fas-username@fedorapeople.org
|
| |
+ ----
|
| |
+
|
| |
+ Upload the file you created to your FedoraPeople account::
|
| |
+ [source,bash]
|
| |
+ ----
|
| |
+ scp /path/to/your-planet-file.txt fas-username@fedorapeople.org:~/.planet
|
| |
+ ----
|
| |
+
|
| |
+
|
| |
+ [[join-sub-planet]]
|
| |
+ == Join a Sub-Planet
|
| |
+
|
| |
+ A Sub-Planet is a special category on Fedora Planet.
|
| |
+ A Sub-Planet focuses on a specific topic or kind of activity in Fedora.
|
| |
+ Examples of the Sub-Planets we publish today are http://fedoraplanet.org/desktop[Desktop], http://fedoraplanet.org/design[Design], http://fedoraplanet.org/summer-coding[Summer Coding], and more.
|
| |
+
|
| |
+ The instructions are the same but you must use a special file name inside your FedoraPeople account.
|
| |
+ For example, if you want to add a category on your blog to the Desktop Sub-Planet, name the file `.planet.desktop` _instead of_ `.planet`.
|
| |
+ For the Summer Coding Sub-Planet, this would be `.planet.summer-coding`.
|
| |
+ For other Sub-Planets, use the URL for that Sub-Planet to name your file.
|
| |
+
|
| |
+ If you're unsure if your content belongs in a Sub-Planet, ask the Mindshare Committee in irc://irc.freenode.net/#fedora-mindshare[#fedora-mindshare] on Freenode.
|
| |
+
|
| |
+
|
| |
+ [[content-guidelines]]
|
| |
+ == Content guidelines
|
| |
+
|
| |
+ Fedora Planet is a place for Fedora contributors to express many ideas.
|
| |
+ Not every idea needs to be promotional.
|
| |
+ Some may be controversial, critical, or evoke other responses.
|
| |
+ However, all posts to the Planet must adhere to the https://docs.fedoraproject.org/fedora-project/project/code-of-conduct.html[Fedora Code of Conduct].
|
| |
+ Inappropriate material may be removed from Fedora Planet without prior notice.
|
| |
+
|
| |
+
|
| |
+ [[additional-help]]
|
| |
+ == Additional help
|
| |
+
|
| |
+ The Fedora {FWIKI}/Infrastructure[Infrastructure Team] can help with technical problems or issues.
|
| |
+ Reach out to them on their IRC channel on Freenode (irc://irc.freenode.net/#fedora-admin[#fedora-admin]) or their https://lists.fedoraproject.org/admin/lists/infrastructure.lists.fedoraproject.org/[mailing list].
|
| |
+
|
| |
+
|
| |
+ [[reporting-bugs]]
|
| |
+ === Reporting bugs
|
| |
+
|
| |
+ If you find a bug, email the mailto:webmaster@fedoraproject.org[Websites team].
|
| |
+ Include a description, screenshot (if available), browser name and version, and what operating system you use.
|
| |
jflory7
commented 6 years ago
This PR adds a Fedora Planet doc to the On-boarding Guide. This is converted and modernized from the Fedora Planet wiki page. It also sets up other minor details for the on-boarding guide in the context of docs-fp-o.