1. Make a GitHub account. If you are on the programming team, you should already have one.

  2. Ask the programming lead to add you to the Team-2502 Github organization

  3. Clone the repository for this wiki

  4. Think about what kind of wiki page you will make. If it’s a wiki page related to build, navigate to the _build directory. If it’s related to maintaining this wiki, navigate to the _wiki folder. If it’s related to programming, navigate to the _programming directory. These directories are called collections. The placement of your page will impact which index your page shows up in.

  5. Make a new file. Ensure the name is all lowercase, has no spaces, and briefly describes the purpose of the page.

  6. Now, you need to add some YAML front matter. YAML front matter goes at the beginning of your file and looks like

---
layout: post
title:  "How to add wiki pages"
category: Meta
---

You will need to edit the title.

Additionally, edit the category. If your programming page is about how to do something related to WPILib, change the line with categories to category: WPILib. If your build page is related to design, change it to category: Design. Do your best to keep your page within the existing categories. The category will let the index automatically sort your wiki page. Use the category field to sensibly categorize your pages.

7. Commit your change to the master branch

8. Once it is accepted, your page will be visible on the wiki!

We use a program called Jekyll for our wiki. Check out the Jekyll docs for more info on how to get the most out of Jekyll. File all bugs/feature requests at Jekyll’s GitHub repo. If you have questions, you can ask them on Jekyll Talk.