Task files are named OB_<task name with spaces replaced by underscores>.md. The script derives the filename directly from the dropdown selection, so there is no separate name-to-file mapping to maintain.
For this guide, the placeholder name will be "Example Task".
- Create
tasks/OB_Example_Task.mdwith the task instructions. The filename must follow the patternOB_+ task name with spaces replaced by underscores. - Add the task name to the dropdown options in
.github/ISSUE_TEMPLATE/Onboarding.yaml:
options:
- First Day on Github
- First Week on Github
# ...
- Example TaskOnce these changes are merged into main, the new task option will be live.
- Delete the corresponding markdown file from the
tasksfolder. - Remove its name from the dropdown options in
.github/ISSUE_TEMPLATE/Onboarding.yaml.
Edit the corresponding markdown file in the tasks folder. Existing issues will not be updated — the automation only runs once when an issue is opened. A new issue must be created to get updated content.
There is no separate deploy step. The automation runs entirely on GitHub Actions and triggers automatically when a new onboarding issue is opened. Once your changes are merged into main, they are live.