As a volunteer or exec, I want a clear guide on how to add events to the CCSS website so that I can promote upcoming events without needing to ask for help or dig through the repo.
🧠 Context
We currently don’t have a documented guide on how to add events to the CCSS website. Contributors are expected to know how the CarletonComputerScienceSociety/website repo works and where to place files, which creates unnecessary friction.
We should publish a page at:
https://handbook.carletoncomputersciencesociety.ca/docs/guides/website/add-events
This page should provide a step-by-step guide with code examples showing:
- How to add a new event to the website
- Where to put the markdown file
- Where to upload the event poster
🛠️ Implementation Plan
-
Create a new page at:
docs/guides/website/add-events.md
-
Write a guide on this page:
-
A short intro sentence explaining that this guide helps you add an event to the CCSS website
-
Step 1: Create an event markdown file
-
Step 2: Add your event poster
-
Step 3: Commit your changes
- Include both the markdown file and the image in your PR
- Example commit message:
Add Frosh Social event for Sept 10
-
Ensure the page has proper formatting
✅ Acceptance Criteria
As a volunteer or exec, I want a clear guide on how to add events to the CCSS website so that I can promote upcoming events without needing to ask for help or dig through the repo.
🧠 Context
We currently don’t have a documented guide on how to add events to the CCSS website. Contributors are expected to know how the
CarletonComputerScienceSociety/websiterepo works and where to place files, which creates unnecessary friction.We should publish a page at:
This page should provide a step-by-step guide with code examples showing:
🛠️ Implementation Plan
Create a new page at:
docs/guides/website/add-events.mdWrite a guide on this page:
A short intro sentence explaining that this guide helps you add an event to the CCSS website
Step 1: Create an event markdown file
Go to content/events
Add a new file named something like
2024-09-10-frosh-social.mdInclude an example frontmatter and body content:
Step 2: Add your event poster
images/event_posters/2024/event-name.jpgStep 3: Commit your changes
Add Frosh Social event for Sept 10Ensure the page has proper formatting
✅ Acceptance Criteria
A new page exists at
docs/guides/website/add-events.mdThe guide includes:
All links point to the correct GitHub repo paths
The page is properly formatted and appears in the sidebar under "Guides > Website"