#2 Add Fedora Planet doc, other misc. setup for on-boarding guide
Merged by jflory7. Opened by jflory7.
add/fedora-planet  into  master

Download 2.patch

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.

Screenshot of Fedora Planet page

rebased onto 7cc771c5d46f414c33542261e1b2ad00a39ab406

Metadata Update from @jflory7:
- Pull-request tagged with: add doc, needs feedback

Nitpick:
Please consider using a full link macro here.
link:http://fedoraplanet.org/[Fedora Planet]

Not a big problem, though, as URLs beginning with https:// (and other standard prefixes) are automatically parsed by AsciiDoctor.
Please feel free to ignore this nitpick:)

I'd personally avoid contractions (Ln#8) and Saxon possessives (Ln#9).

What would this be referring to on line 24?
Filtering your content? Setting up a feed of your content to Fedora Planet? The wording seems slightly ambiguous in this paragraph .
Please use pronouns with caution:)

I'd be inclined to use 2 words: plain text as opposed to plaintext, because:
1. plain text appears to be used considerably more often in technical writing.
2. plaintexthas connotations related to cryptography, which do not apply to this context

@ssitani Thanks for the feedback. The latest commit addresses all of your feedback. Thanks for the nitpicks. :thumbsup:

rebased onto 3e9d1aebfd7eeab4b511d5c69875203cda89017c

Metadata Update from @jflory7:
- Pull-request untagged with: needs feedback
- Request assigned

I could easily see this turning into a bullet list htat just lists the content i.e.

  • sexual images ...
  • copyright violations ...
  • other material which violates the CoC

no need to explain why.

WDYT? CC: @mattdm

I don't know if we even need a list. Actually, I'd just remove the == Inappropriate material and put "Inappropriate material may be removed from Fedora Planet without prior notice." as the last sentence of == Appropriate material — that section already references the CoC.

1 new commit added

  • Revise content guidelines based on feedback in PR#2

@bex @mattdm I made a new commit based on your feedback. I opted to remove the Inappropriate content section, moved the disclaimer about inappropriate content, and renamed Appropriate content to Content guidelines.

Unless you're referring to the Your Name placeholder itself, I'd use a regular font as opposed to bold. If you'd like to designate a placeholder inside the code block, you might prepend the [subs=+quotes] attribute

Pull-Request has been merged by jflory7

Metadata