pingou / infra-docs

Forked from infra-docs 6 years ago
Clone

76e9750 Update Fedora Badges SOP for 2018 best practices

Authored and Committed by jflory7 5 years ago
    Update Fedora Badges SOP for 2018 best practices
    
    This is a huge commit for this document and makes a number of changes.
    I've split them up into two sections: content and style. By making this
    PR, I am also accepting a conditional responsibility for maintaining
    this content too. :P
    
    Content
    -------
    
    * **Existing content**:
        * Update invitation instructions for user email instead of ID
        * Update some broken links
    * **New content**:
        * Completely rework section on pushing badges; aggregated
          information from a variety of sources ¹ ² ³
    
    Style
    -----
    
    * Follow one-sentence per line convention for easier git diffs
    * Insert more links and create an appendix for commonly-used links
    * Follow ReStructuredText style guide for headers
    * Generally make content easier to read when rendered with better markup
      (will be helpful especially for Flock Badges sysadmin workshop)
    * Other small, trivial changes
    
    ¹ https://pagure.io/fedora-docs/quick-docs/pull-request/36
    ² https://pagure.io/fedora-badges/pull-request/617
    ³ https://blog.justinwflory.com/2016/07/push-fedora-badges/