Contribution guide

Author(s): catinsurance
Tags:

---

Thanks for showing interest in contributing to the Isaac Blueprints! This guide will serve as a quick start to creating articles, as well as a good formatting example itself.

Contributing

To get started, create a fork of the Isaac Blueprints repository on Github. Then, clone this respository to your desktop.

To start writing an article or making an edit to an existing one, you should first create a branch that contains the changes you'll be making. After that, create a Markdown file in an appropriate subfolder within docs/tutorials. Isaac Blueprints is built on Markdown and Material for MkDocs.

If you want to add images, gifs, or other files to your article, create a new folder within docs/tutorials/assets named after your article's name. Use snake_case for naming any new files.

If creating a new article, please add the appropriate metadata at the top so that the header can be generated properly. It should have the following properties:

• An article property with the name of the article. This appears in the primary header.
• An authors property with the creator(s) of article. Separate multiple authors with commas (i.e. authors: joe, bob).
• A comments property for if you want comments to be enabled. This should be true or false, and should be left as true under most circumstances.
• A tags property with a list of tags.

List of tags

The following are the allowed tags:

• Beginner friendly
• Intermediate
• Advanced
• Tutorial
• Video
• Lua
• No Lua
• Sprites
• XML
• Repentance
• Repentance+
• REPENTOGON

When you're ready to submit your changes for review, create a pull request on Isaac Blueprints respository using your branch. Your changes will be reviewed by a repository maintainer (usually catinsurance).

Hosting the docs locally

It is recommended to host the docs locally before creating a pull request with your changes in order to preview the formatting. To host the docs locally, follow these steps:

1. Make sure you have Python downloaded. If on Windows, make sure it was added to PATH. Python does this automatically upon downloading it, as long as you ticked the box.
2. Navigate to repository's directory on your PC with command prompt, and type the follow in order to automatically download all necessary packages.

   py -m pip install ./requirements.txt
   

   
3. While still in the directory in command prompt, type mkdocs serve to host the site.
4. Visit localhost:8000 in your browser to see the site!

Article guidelines

• Keep articles objective! Try to avoid inserting opinionated statements. If an article requires you to say something opinionated, please denote that what you are saying is not fact.
• Pay attention to grammar and spelling.
• Every article should have a short preamble explaining what it's about.
• When talking about REPENTOGON in an article not exclusively focused around something regarding it, please use the REPENTOGON emoji (:modding-repentogon:) before the sentence mentioning it.
• When referencing an API method for the first time, please create a hyperlink ([text](https://www.example.com/)) to its description in the community docs. This should also be done when referencing an external resource for the first time. After linking things once, there is no need to link it again.

Formatting

• A Markdown formatting cheat sheet can be found here.
• When making a header for a section, use two hash symbols (##) instead of one.
• You can create an info, warning, or bug collapsable using the following system:

Collapsable info

???- info "Closed info collapsable"
    This is a closed info collapsable!

???+ info "Opened info collapsable"
    This is a opened info collapsable!

Collapsable warning

???+ warning "Opened warning collapsable"
    This is a opened warning collapsable!

???- warning "Closed warning collapsable"
    This is a closed warning collapsable!

Collapsable bug

???+ bug "Opened bug collapsable"
    This is a opened error collapsable!

???+ bug "Closed bug collapsable"
    This is a closed bug collapsable!

---