⚠️ Legacy Documentation

Warning: This documentation is outdated and references PGM (ProjectAres) as it was used on the Overcast Network. This repository is no longer actively maintained.

For current PGM documentation, please visit: https://pgm.dev

---

PGM XML Documentation

Documentation for the XML format PGM uses to define map specific features. Pages are hosted using github pages.

Editing Notes

1. Pages are formatted in markdown and may contain HTML, HTML should only be used where absolutely needed.
2. Markdown is parsed with kramdown which has an enhanced syntax.
3. Care should be taken when removing trailing whitespace since markdown uses two spaces to create a newline.

Pull Requests

Pull requests should have the following things:

1. The commits should have a descriptive message and which is not in the past tense.

   For example: Describe the XYZ module with more detail. or Add detailed description for XYZ. is good, but: Added XYZ. isn't.

2. Content should be grammatically correct and the spelling should be US English, e.g. Color not Colour.

Previewing your changes

1. Install Ruby 3.1 or later (rbenv recommended for macOS/Linux, RubyInstaller for Windows)
2. Install bundler: gem install bundler
3. Run bundle install from the source root
4. Run bundle exec jekyll serve
5. Load http://localhost:4000 in your browser