Site Structure Document

Synthesised from full content audit — June 2026

---

Part 1: What We Have — Content Audit Summary

Content Status Key

• FULL — complete, publish-ready
• PARTIAL — real content but Coda tables/links missing or file cuts off
• STUB — one sentence describing what's in Coda; content not exported
• EMPTY — frontmatter only or <!-- No content available -->

---

Root Level

---

current-teaching (was DRAFT_current-teaching)

Mathematics

AIML Web Authoring ← Most complete course in the export

Standard Web Authoring & Databases

Research & Study Skills

AI for Business

AI Workshops for Teachers ← Second most complete section

Communications ← Strongest section overall

Personal & Professional Development

---

teaching-materials

Guides

Handouts & Assignments

Prior Teaching — Nearly total export failure; all content is in Coda

---

Part 2: Proposed New Structure

/ (vault root)
├── index.md                           REWRITE — fix bio, links, add audience nav
├── consulting.md                      DONE (this session)
├── contact.md                         RENAME from HIDDEN_contact.md, publish: false
│
├── current-teaching/                  FOR STUDENTS
│   ├── index.md                       WRITE
│   ├── mathematics/
│   │   ├── index.md                   RECOVER from Coda
│   │   └── worksheets/
│   │       └── index.md               RECOVER from Coda
│   ├── web-authoring-and-databases/
│   │   ├── index.md                   RECOVER from Coda
│   │   ├── programs-to-install.md     REWRITE (or fold into index)
│   │   └── 2026-27/                   CREATE (new year folder)
│   ├── aiml-web-authoring/            RENAME — remove DRAFT_
│   │   ├── index.md                   FIX Coda body links
│   │   ├── assignment-1/
│   │   │   ├── index.md               FULL — just rename folder
│   │   │   ├── planning-template.md   FULL
│   │   │   └── readme-template.md     FULL
│   │   └── project/
│   │       ├── index.md               FULL — rename folder
│   │       ├── planning-template.md   FULL
│   │       └── readme-template.md     FULL
│   ├── research-and-study-skills/
│   │   ├── index.md                   RECOVER from Coda
│   │   └── the-humble-banana/
│   │       ├── index.md               RECOVER from Coda
│   │       └── pick-your-frame.md     RECOVER from Coda
│   ├── ai-for-business/
│   │   ├── index.md                   RECOVER from Coda
│   │   └── prompt-guides.md           RECOVER (see also handout 4)
│   └── programming-design-principles/ NEW COURSE
│       └── index.md                   CREATE
│
├── resources/                         FOR STUDENTS (primarily)
│   ├── index.md                       WRITE
│   ├── mathematics.md                 WRITE
│   ├── programming.md                 WRITE (Python focus)
│   ├── web-development.md             WRITE
│   ├── ai-and-machine-learning.md     WRITE
│   ├── research-and-study.md          WRITE
│   └── professional-development.md    WRITE (draw on PPD brief 4 materials)
│
├── for-teachers/                      FOR TEACHERS / COLLEAGUES
│   ├── index.md                       WRITE
│   ├── how-i-think-about-teaching.md  WRITE — high value for consulting
│   └── ai-workshops/
│       ├── index.md                   WRITE overview
│       ├── non-technical/
│       │   ├── index.md               FIX Coda body links → sibling pages
│       │   ├── 0-ai-technologies.md   RECOVER table from Coda
│       │   ├── 1-understanding-llms-in-context.md   FULL
│       │   ├── 2-tool-limitations/
│       │   │   ├── index.md           RECOVER tables from Coda
│       │   │   └── filled.md          RECOVER tables from Coda
│       │   ├── 3-llms-and-teaching.md FULL
│       │   ├── 4-comprehensive-prompting-guide.md  FULL
│       │   └── 5-educational-prompting-examples.md FULL
│       └── technical/
│           ├── index.md               FULL
│           ├── day-1.md               PARTIAL — add notebook links
│           ├── day-2-3.md             PARTIAL — add tutorial link
│           └── day-3.md               STUB — recover or develop
│
├── for-administrators/                FOR ADMINS / EMPLOYERS
│   ├── index.md                       WRITE
│   ├── norms-and-expectations.md      RECOVER from Coda
│   ├── assessments.md                 WRITE overview
│   └── faqs.md                        WRITE fresh
│
├── guides/                            PUBLIC — general how-to-learn
│   ├── index.md                       WRITE
│   ├── how-to-learn-mathematics.md    RECOVER from Coda + complete
│   ├── how-to-learn-computer-science.md  WRITE or cut
│   ├── learning-math-through-programming.md  FULL (this session)
│   ├── how-to-learn-programming/
│   │   ├── index.md                   RECOVER from Coda
│   │   └── learning-python.md         WRITE (needed for PDP course)
│   └── how-i-recommend-learning-to-learn.md  WRITE
│
├── writings/                          DIGITAL GARDEN (new)
│   └── index.md                       WRITE intro + seed from HIDDEN_random-writings
│
└── archive/                           PUBLIC — stays findable
    └── 2025-26/
        ├── index.md                   WRITE brief intro
        ├── communications/
        │   ├── index.md               FULL (fix 3 Coda body links)
        │   ├── artist-statement-brainstorming.md   FULL
        │   ├── artist-statement-outline.md         FULL
        │   ├── grants-and-residencies-research-activity.md  FULL
        │   └── reflections-on-intro-task.md        STUB (keep as handout or cut)
        ├── personal-and-professional-development/
        │   ├── index.md               STUB — write brief intro
        │   ├── templates-and-briefs/
        │   │   ├── brief-1-github-pages/    RECOVER from Coda
        │   │   ├── brief-2-case-study/      RECOVER from Coda (incl. 5 worksheets)
        │   │   ├── brief-3-year-planning/   FULL (fix typo, fill deadline)
        │   │   └── brief-4-professional-materials/  FULL (fill deadline)
        │   └── development-process-worksheet.md   RECOVER from Coda
        └── prior-teaching/
            ├── index.md               WRITE brief intro
            ├── bfei/
            │   └── oop/               RECOVER solar system series from Coda
            └── dcfe/
                ├── maths-for-it/      RECOVER from Coda
                ├── web-authoring/     RECOVER from Coda
                ├── ai-for-business/   RECOVER from Coda
                └── programming-design-principles.md  RECOVER (seed for new course)

---

Part 3: Files to Delete

These have no content worth preserving and are either duplicates, internal working docs, or empty placeholders:

• HIDDEN_scratch-paper.md
• teaching-materials/writing-and-reading.md
• teaching-materials/assorted-teaching-materials.md
• teaching-materials/handouts-and-assignments/index.md (or replace with "see Moodle" note)
• teaching-materials/other-teaching.md → moved/replaced by archive/prior-teaching/index.md
• teaching-materials/index.md → superseded by new structure
• DRAFT_current-teaching/DRAFT_assessment-brief-github-pages.md → duplicate of brief_1
• DRAFT_current-teaching/DRAFT_somewhat-traditional-worksheets/annotated-unverified-sheets.md
• DRAFT_current-teaching/DRAFT_the-humble-banana/HIDDEN_pick-your-frame.md → recover from Coda first, then delete the empty shell
• technical-ai-workshops/other-days-coming-soon.md
• BFEI/FOOP/learning-csharp.md, oop-map-notebook.md, oop-notebooks.md → all empty, recover or cut
• DRAFT_current-teaching/communications/reflections-on-intro-task.md → keep only if developed into a handout

---

Part 4: Files to Merge

---

Part 5: Coda Links to Fix

These body-level Coda links (not frontmatter) need to become relative links:

All coda_page_id and coda_url frontmatter fields → strip from all 101 files (script).

---

Part 6: Coda Content to Recover

These files have real content confirmed to exist in Coda (either described as "full" in their stub text, or visible in a previous Coda session) but were not exported:

High Priority (directly needed to publish)

• norms-and-expectations.md — full classroom document
• cross-module-integration-summary.md — key piece for consulting narrative
• how-to-learn-mathematics.md — good essay, only first sentence exported
• how-to-learn-programming/index.md — described as full guide
• Handout 0 table (AI approaches comparison) — central to workshop handout 0
• Handouts 2 (blank and filled) exercise tables — central to the exercise

Medium Priority (archive / new year prep)

• All PPD Brief 1 and Brief 2 content (incl. 5 worksheets)
• Maths for IT content (class notes, problem set 1)
• DCFE Programming Design Principles (seed for new course)
• Web Authoring class notes (DCFE)
• The Humble Banana brief and Pick Your Frame worksheet

Lower Priority (archive)

• BFEI FOOP solar system series (1–3)
• DCFE AI for Business class notes
• Student backgrounds questionnaire

---

Part 7: Things to Write From Scratch

These don't exist in Coda in any meaningful form and need to be written:

---

Part 8: Suggested Order of Operations

Immediate (unblocks everything else)

1. Decide publishing platform → determines frontmatter convention
2. Strip all coda_page_id and coda_url frontmatter (script — 101 files)
3. Rename all DRAFT_ and HIDDEN_ folder/file prefixes (script)

Week 1 — Structure

4. Create new folder structure (current-teaching/, for-teachers/, for-administrators/, resources/, guides/, writings/, archive/)
5. Move existing content into new locations
6. Fix the 5 sets of Coda body links (Part 5)
7. Delete the 12 files marked for deletion (Part 3)
8. Perform the 6 merges (Part 4)

Week 1–2 — Quick wins (FULL pages need only minor edits)

9. Fix brief_3 and brief_4 typos/blank deadlines → publish
10. Fix the 4 Communications handouts → publish
11. Fix AIML Web Authoring briefs (review numbering gaps) → publish
12. Fix AI Workshop handouts 1, 3, 4, 5 → publish
13. Rewrite current-teaching/index.md (student landing)
14. Rewrite homepage index.md (bio + CV + audience nav)

Week 2–3 — Coda recovery (Part 6)

15. Open Coda and recover high-priority content
16. Fill norms-and-expectations.md and cross-module-integration-summary.md
17. Complete how-to-learn-mathematics.md
18. Fill handout 0 table and handout 2 exercise tables

Week 3–4 — Write from scratch (Part 7)

19. for-teachers/how-i-think-about-teaching.md
20. guides/learning-python.md (needed for new PDP course)
21. resources/ — 6 subject pages
22. for-administrators/ — index, assessments, faqs
23. writings/index.md
24. programming-design-principles/index.md

When ready — Publish

25. Configure publishing platform
26. Set publish: false on anything not ready
27. Test locally → go live