Editing Guide to Changelogs (section)

== Creating a Changelog == 

=== Online auto-creation ===
By formatting text in the body of your PR description you can have a changelog .yml file automatically generated for you.
Declare the start of a changelog entry with :cl: and close it with /:cl:; anything in between these two tags will included, remember to use prefixes for each line. See below for a list of valid prefixes.
An author can be set after the :cl: tag, if omitted your Github username will be used by default.

'''Format example:'''
    :cl: Deantwo
    rscadd: Added laser rifles for everyone.
    rscdel: Removed everyone's brains.
    /:cl:

=== Committing a .yml file ===
PR changelogs are temporary and just get deleted after they're merged into the master changelog.

# Create <code>html/changelogs/''USERNAME-BRANCHNAME''.yml</code>.
## Go to <code>/master/html/changelogs/</code> on your branch.
## Create file <code>''USERNAME-BRANCHNAME''.yml</code> in the folder, where 'BRANCHNAME' the name of the branch on your fork and 'USERNAME' is your github username.
##* Example: <code>Deantwo-BrainlessShooting.yml</code>
##* File name is not super important but helps the maintainers know who made the file and which PR it is related to. Also prevents conflicts since two files won't have the same name.
# Copy the contents of [https://github.com/tgstation/-tg-station/blob/master/html/changelogs/example.yml this].
# Fill it out.
#* Make sure to set delete-after to true.
#* Also ensure you update the author name so you get credited appropriately.
# '''PROOFREAD.''' Changelog entries are final after they're merged.
# Add it to git so it's included with your PR.

'''File content example:'''
    author: Deantwo
    
    delete-after: True
    
    changes: 
      - rscadd: "Added laser rifles for everyone."
      - rscdel: "Removed everyone's brains."

=== Updating the Changelog ===

:''Only maintainers need to do this.''

* First, install python3, pip, and PyYaml:
** After installing python and ensuring it and its Scripts/ folder is in PATH, download and run [https://raw.githubusercontent.com/pypa/pip/master/contrib/get-pip.py get-pip.py] with python.
** Once pip is installed run the following commands in your terminal
** <code>pip install PyYaml</code>
** <code>pip install beautifulsoup4</code>
* With /tg/station's code, simply run makeChangelog.bat.
* On Linux or other codebases, run <code>python tools/ss13_genchangelog.py html/changelog.html html/changelogs</code>