- Changed Milestones to be handled in front matter of each proposal instead of yml - Updated ReadMe - Put different ReadMe sections into individual User Guides
2 KiB
layout | title |
---|---|
static_page | How to update the Roadmap |
Edit the .yml file
Navigate to the /_data/
folder and open roadmap.yml
. You will notice a list separated by hyphenated -year
tags.
DO NOT MESS WITH THE FORMATTING OR INDENTATION OF ANYTHING OR JEKYLL WILL NOT BUILD PROPERLY!
Find the year that you want to update and copy the code below:
- name:
date:
status:
and paste it in the correct years accomplishments:
section IN THE CHRONOLOGICAL ORDER that it will be in. So if there is a accomplishment that happened/is happening before the one you are inputting, make sure it is higher up than yours. If there is an accomplishment that happened/is happening AFTER yours, make sure it is after yours. If you don't have exact dates, just do your best to estimate.
Fill in the data as follows:
name:
The name of the accomplishment. Try to keep it short, a sentence or two at most.date:
When the accomplishment happened (past) or when it is expected to happen (future)status:
If the task is done, putcompleted
, if the task is currently in the works putongoing
, and if work on the task has not yet started to your knowledge, but is expected to, putupcoming
.
Make sure the indentation is EXACTLY the same as the other proposals in the area. If it's not the jekyll build WILL fail.
Save the file.
Build/Test
Build your website using jekyll serve
if it's not rebuilding automatically. If the build fails and you receive an error, you may have messed up somewhere in the roadmap.yml
file back in 10.1. Go back to that section and check the indentation. Yes, it's stupid. Yes, it has to be perfect.
If the build is successful, go to the Events page /resources/roadmap/
and check to see that the newly added accomplishment is showing up in the correct place in the correct year. Test the page and let rehrar know if there are any bugs.
Submit a Pull Request
You're all done. Submit a PR and wait for it to be reviewed and merged. Be sure to make any changes if requested.