Skip to content

Commit 7890120

Browse files
committed
chore: add 2026 content strategy and initiative briefs
1 parent 5c87c84 commit 7890120

File tree

12 files changed

+733
-0
lines changed

12 files changed

+733
-0
lines changed

content-strategy/2026-plan.md

Lines changed: 137 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,137 @@
1+
# CoderLevelUp — 2026 Site Update Plan
2+
3+
## Context
4+
5+
This is the Jekyll source for [coderlevelup.org](https://coderlevelup.org), built on the Jasper2 theme (Ghost Casper port), deployed via GitHub Actions to GitHub Pages.
6+
7+
The site is being updated to reflect CoderLevelUp's current portfolio of initiatives. The tagline stays: **"Levelling up our coding community, in Africa."**
8+
9+
All initiative background is in `content-strategy/initiatives/`. Read the relevant file before writing any post or tag page.
10+
11+
> **Note for Claude Code:** `content-strategy/` is excluded from Jekyll builds via `_config.yml`. If that exclude entry is missing, add it before doing anything else.
12+
13+
---
14+
15+
## _config.yml — Check First
16+
17+
Ensure this is in the exclude list:
18+
19+
```yaml
20+
exclude:
21+
- content-strategy/
22+
```
23+
24+
---
25+
26+
## Task 1 — Update `_data/tags.yml`
27+
28+
Add entries for all new tags. Follow the existing format exactly. Each tag needs:
29+
30+
- `slug` — matches the tag used in post frontmatter
31+
- `name` — display name
32+
- `description` — 1–2 sentence summary shown on the tag page
33+
- `cover` — path to cover image (placeholder: `assets/images/covers/[slug].jpg` if not yet available)
34+
35+
**Full tag list:**
36+
37+
| Slug | Name | Status |
38+
|---|---|---|
39+
| `codeclub` | Code Club | existing — add description if missing |
40+
| `coolestprojects` | Coolest Projects | existing — add description if missing |
41+
| `pico-pathway` | Pico Pathway | NEW |
42+
| `first` | FIRST | NEW |
43+
| `ftc` | FTC | NEW |
44+
| `sapient-rocks` | SAPIENT | NEW |
45+
| `mars-yard` | Mars Yard | NEW |
46+
| `loco-auv` | LoCO AUV | NEW |
47+
| `coderetreat` | CodeRetreat | existing — add description if missing |
48+
| `devdev` | devdev | existing — add description if missing |
49+
50+
---
51+
52+
## Task 2 — Create Tag About Pages
53+
54+
For each tag, create a page at `tag/[slug].html` using the layout and frontmatter convention already in use for existing tag pages. Check existing ones before writing new ones.
55+
56+
Typical pattern:
57+
58+
```yaml
59+
---
60+
layout: tag
61+
tag: ftc
62+
title: "FTC"
63+
description: "..."
64+
cover: assets/images/covers/ftc.jpg
65+
permalink: /tag/ftc/
66+
---
67+
```
68+
69+
Create one for every tag in the list above that doesn't already have one.
70+
71+
---
72+
73+
## Task 3 — Create New Posts
74+
75+
One introductory post per new initiative minimum. Posts live in `_posts/` with filename `YYYY-MM-DD-slug.md`.
76+
77+
Check existing posts for frontmatter conventions before writing. Typical pattern:
78+
79+
```yaml
80+
---
81+
layout: post
82+
current: post
83+
cover: assets/images/covers/ftc.jpg
84+
navigation: True
85+
title: "Post Title"
86+
date: 2026-03-01 10:00:00
87+
tags: [ftc, first]
88+
class: post-template
89+
subclass: 'post tag-ftc'
90+
author: campey
91+
---
92+
```
93+
94+
**Posts to create:**
95+
96+
| Initiative | Brief |
97+
|---|---|
98+
| Pico Pathway | `content-strategy/initiatives/pico-pathway.md` |
99+
| FIRST | `content-strategy/initiatives/first.md` |
100+
| FTC | `content-strategy/initiatives/ftc.md` |
101+
| SAPIENT | `content-strategy/initiatives/sapient-rocks.md` |
102+
| Mars Yard | `content-strategy/initiatives/mars-yard.md` |
103+
| LoCO AUV | `content-strategy/initiatives/loco-auv.md` |
104+
105+
---
106+
107+
## Task 4 — Update the About Page
108+
109+
File: `about/index.html` or `about/index.md` — check what exists.
110+
111+
See `content-strategy/initiatives/about.md` for full updated content brief.
112+
113+
---
114+
115+
## Task 5 — Landing Page Ordering
116+
117+
The landing page surfaces the most recent posts. Set post dates to achieve this audience journey top-to-bottom:
118+
119+
1. Code Club / kids coding
120+
2. Coolest Projects
121+
3. Pico Pathway Kit
122+
4. FTC — volunteering angle
123+
5. SAPIENT — Mars Yard & lectures
124+
6. LoCO AUV — community builds
125+
7. CodeRetreat
126+
8. devdev
127+
128+
---
129+
130+
## Repo Conventions
131+
132+
- Primary author: `campey` (defined in `_data/authors.yml`)
133+
- Read existing posts before writing new ones — follow their frontmatter patterns exactly
134+
- Check `_data/tags.yml` before adding tags — avoid duplication
135+
- Cover images: `assets/images/` — use descriptive filenames
136+
- Do not modify `.travis.yml` — CI is now GitHub Actions (`.github/workflows/`)
137+
- Verify locally with `bundle exec jekyll serve` before committing
Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
# About Page Update Brief
2+
3+
## File to Update
4+
5+
`about/index.html` (or `about/index.md` — check what exists in the repo)
6+
7+
## Current State
8+
9+
The about page currently covers CoderLevelUp's original scope: Code Club, CoderDojo, Coolest Projects, CodeRetreat, devdev.
10+
11+
## What to Update
12+
13+
Expand the about page to reflect the full current scope of CoderLevelUp. Keep the tagline: **"Levelling up our coding community, in Africa."**
14+
15+
## Suggested Structure
16+
17+
### Opening
18+
19+
CoderLevelUp has been growing the coding community in Africa since [year]. What started as coding clubs for young people has grown into a broad ecosystem — from beginner learners picking up their first Pico kit, to competitive robotics teams heading to world championships, to planetary science researchers inspiring the next generation of explorers, to professional developers sharpening their craft.
20+
21+
### For Young Coders
22+
23+
**Code Club** — Free volunteer-led coding clubs for young people, aligned to the DBE Coding & Robotics curriculum. [link]
24+
25+
**Coolest Projects** — The world's leading technology showcase for young people, run in South Africa since 2020. [link]
26+
27+
**Pico Pathway Kit** — Our hardware starter kit, available from PiShop for R199.90. Six projects, one kit, endless possibilities. [link]
28+
29+
### Robotics
30+
31+
**FIRST / FTC** — We support First Tech Challenge teams in the Western Cape through IGNITE Robotics International — including 2024 World Champions Texpand. [link]
32+
33+
### Science & Exploration
34+
35+
**SAPIENT** — The South African Planetary Institute for Exploring Nature with Technology. Co-founded with Dr. Matthew Huber, SAPIENT uses planetary science to inspire learners and communities. [link]
36+
37+
**Mars Yard** — A simulated Martian landscape in Cape Town where learners run code on real rovers. [link]
38+
39+
### Ocean Robotics
40+
41+
**LoCO AUV** — A community building a low-cost open-source autonomous underwater vehicle. Monthly build events, open to all. Communities build robots and robots build communities. [link]
42+
43+
### For Professional Developers
44+
45+
**CodeRetreat** — Day-long deliberate practice events for developers. Cape Town chapter since 2012. [link]
46+
47+
**devdev** — A working group under IITPSA developing professional developers in South Africa. [link]
48+
49+
---
50+
51+
## Tone
52+
53+
Warm, proud, community-first. This page should feel like a welcoming overview — not a corporate brochure. Someone landing here should immediately see something they want to get involved with.
54+
55+
## Author
56+
57+
campey (David Campey)
Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# Initiative: Code Club
2+
3+
## Tags
4+
`codeclub`
5+
6+
## What It Is
7+
8+
Code Club is a global network of free, volunteer-led coding clubs for young people aged 9–13. CoderLevelUp is the regional growth partner for Code Club in the Western Cape / South Africa, supporting clubs aligned to the Raspberry Pi Foundation's project pathways.
9+
10+
Code Club sits at the heart of CoderLevelUp's mission — it's the entry point for most young coders, and directly supports the rollout of the Department of Basic Education (DBE) Coding & Robotics curriculum.
11+
12+
## Angle for the Site
13+
14+
- Entry-level, welcoming, aimed at teachers, parents, and learners
15+
- Emphasise: free, volunteer-run, curriculum-aligned
16+
- Link to: DBE curriculum, Raspberry Pi Foundation project pathways
17+
- Connect to: Pico Pathway Kit (the hardware complement to Code Club)
18+
19+
## Key Links
20+
21+
- https://codeclub.org
22+
- https://projects.raspberrypi.org/en (project pathways)
23+
- https://coderlevelup.org/codeclub (existing page — review and update)
24+
25+
## Existing Content on Site
26+
27+
- `/codeclub` — About Code Club (exists, may need refresh)
28+
- `/codeclub-resources` — Resources page (exists)
29+
30+
## Suggested Posts / Content Actions
31+
32+
- Review and refresh the existing `/codeclub` about page
33+
- Ensure the `codeclub` tag has a description in `_data/tags.yml`
34+
- Any new posts should emphasise the DBE curriculum connection and link to the Pico Pathway Kit
35+
36+
## Tag Description (for `_data/tags.yml`)
37+
38+
> Free volunteer-led coding clubs for young people, aligned to the DBE Coding & Robotics curriculum. CoderLevelUp supports Code Club across the Western Cape.
Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
# Initiative: CodeRetreat
2+
3+
## Tags
4+
`coderetreat`
5+
6+
## What It Is
7+
8+
A coderetreat is a day-long event for experienced developers — pair programming with new people, sharing practices, and deliberate practice far from the pressure of getting things done. CoderLevelUp has been running coderetreats in Cape Town since 2012, with approximately 20 retreats to date.
9+
10+
CodeRetreat is part of the global [coderetreat.org](https://coderetreat.org) movement. The Global Day of CodeRetreat runs annually, with developers from around the world participating simultaneously.
11+
12+
## Past Events on Site
13+
14+
- Global Day of CodeRetreat 2021 (Nov 12–13)
15+
- 48 Hour Global Day of CodeRetreat 2022 (virtual, space-station format)
16+
17+
## Audience
18+
19+
Experienced developers (adults primarily, occasionally younger — youngest participant was 12). Anyone who writes code professionally and wants to improve their craft.
20+
21+
## Angle for the Site
22+
23+
- Professional development through deliberate practice
24+
- Community of practice — meet other developers, learn new approaches
25+
- Part of the `devdev` ecosystem (professional developer development)
26+
- Cape Town tech community anchor event
27+
28+
## Key Links
29+
30+
- https://coderetreat.org
31+
- https://coderlevelup.org/coderetreat (existing about page — review)
32+
- https://coderlevelup.org/globaldayofcoderetreat2022-48hr
33+
- https://coderlevelup.org/globaldayofcoderetreat2021
34+
35+
## Content Actions
36+
37+
- Ensure `coderetreat` tag has a description in `_data/tags.yml`
38+
- Review existing about page — likely fine, may need minor refresh
39+
- Any future event posts should use the `coderetreat` tag
40+
41+
## Tag Description (for `_data/tags.yml`)
42+
43+
> Day-long deliberate practice events for developers — pair programming, new partners, no pressure to ship. CoderLevelUp has hosted coderetreats in Cape Town since 2012, including the global 48-hour event.
Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# Initiative: Coolest Projects
2+
3+
## Tags
4+
`coolestprojects`
5+
6+
## What It Is
7+
8+
Coolest Projects is the world's leading technology fair for young people, run by the Raspberry Pi Foundation. CoderLevelUp has organised the South African edition since 2020 — making it the first and longest-running instance in Africa. The event is a showcase (like a science fair) where young people present technology projects they've built themselves.
9+
10+
2025 was the sixth South African edition.
11+
12+
## Angle for the Site
13+
14+
- Celebratory, inspiring, community-facing
15+
- Emphasise: young people building real things, open to all skill levels
16+
- Audience: parents, teachers, learners, sponsors, volunteers
17+
- Connect to: Code Club (where many participants come from)
18+
19+
## Key Links
20+
21+
- https://coolestprojects.org
22+
- https://coderlevelup.org/coolestprojects2025 (existing — most recent)
23+
- https://coderlevelup.org/coolestprojects2024
24+
25+
## Existing Content on Site
26+
27+
Posts exist for 2020, 2022, 2023, 2024, 2025. These are in good shape. Focus on:
28+
- Ensuring the `coolestprojects` tag has a proper description
29+
- Making sure the 2025 post is featured / prominent on the landing page
30+
31+
## Tag Description (for `_data/tags.yml`)
32+
33+
> The world's leading technology showcase for young people, run in South Africa since 2020. CoderLevelUp organises the annual Cape Town edition, now in its sixth year.
Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# Initiative: devdev
2+
3+
## Tags
4+
`devdev`
5+
6+
## What It Is
7+
8+
devdev is a working group focused on developing professional developers. It operates under IITPSA (Institute of Information Technology Professionals South Africa) — the professional body for IT professionals in South Africa.
9+
10+
**devdev's primary goal:** Make it easier to employ and be employed in the software development profession in South Africa.
11+
12+
## Audience
13+
14+
Professional software developers, hiring managers, HR professionals, people entering the tech profession.
15+
16+
## Angle for the Site
17+
18+
- The professional / adult dimension of CoderLevelUp's work
19+
- Complements CodeRetreat as a pro developer community touchpoint
20+
- IITPSA connection gives it professional credibility
21+
- Practical: pathways into and through the profession
22+
23+
## Key Links
24+
25+
- https://iitpsa.org.za
26+
- https://coderlevelup.org/devdev (existing page — review)
27+
28+
## Content Actions
29+
30+
- Ensure `devdev` tag has a description in `_data/tags.yml`
31+
- Review existing about page — may need minor refresh to reflect current status
32+
- Link to CodeRetreat as the community practice complement
33+
34+
## Tag Description (for `_data/tags.yml`)
35+
36+
> A working group under IITPSA developing professional developers in South Africa — making it easier to employ and be employed in the software profession.
Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
# Initiative: FIRST
2+
3+
## Tags
4+
`first`
5+
6+
## What It Is
7+
8+
FIRST (For Inspiration and Recognition of Science and Technology) is a global robotics organisation founded by inventor Dean Kamen. It runs a family of youth robotics competitions at different age levels and skill tiers:
9+
10+
- **FLL Discover** (ages 4–6)
11+
- **FLL Explore** (ages 6–10)
12+
- **FLL Challenge** (ages 9–16) — Lego robotics
13+
- **FTC** (ages 12–18) — First Tech Challenge (CoderLevelUp's primary focus)
14+
- **FRC** (ages 14–18) — First Robotics Competition
15+
16+
FIRST's mission: inspire young people to be science and technology leaders and innovators, by engaging them in exciting mentor-based programs that build science, engineering, and technology skills.
17+
18+
## Angle for the Site
19+
20+
- FIRST is the umbrella; FTC is the specific programme CoderLevelUp supports
21+
- Use `first` tag for content about the FIRST organisation broadly, SA context, and the volunteering ecosystem
22+
- Emphasise: mentorship model, real engineering skills, global competition pathway
23+
- South Africa context: growing FIRST community, Western Cape teams are competitive internationally
24+
25+
## Key Links
26+
27+
- https://firstinspires.org
28+
- https://www.firstinspires.org/robotics/ftc
29+
- https://www.ignite-robotics.co.za (IGNITE Robotics International — SA coordinator)
30+
31+
## Post to Write
32+
33+
**Title:** FIRST Robotics in South Africa — Why We're Getting Involved
34+
35+
**Key points:**
36+
- What FIRST is and why it matters
37+
- The ladder from FLL through FTC to FRC
38+
- CoderLevelUp's role: supporting teams, volunteering, community building
39+
- IGNITE Robotics as the SA coordinator
40+
- Call to action: volunteer, sponsor, follow the teams
41+
42+
## Tag Description (for `_data/tags.yml`)
43+
44+
> FIRST (For Inspiration and Recognition of Science and Technology) runs world-class youth robotics programmes from Lego FLL through to the First Tech Challenge. CoderLevelUp supports the FIRST community in South Africa.

0 commit comments

Comments
 (0)