OEG Confluence Revamp — Workplan

Started: 2026-05-20 · Owner: Casey Iiams-Hauser (with Claude) · Status: Phase 1 substantial · Phase 2 done · Phase 3 partial · Phase 4 done

Progress as of 2026-05-21: ~60+ pages re-parented under the new audience-aligned structure; homepage rewritten as Start Here; all 7 section landing pages have full Start Here copy with reading order and how-to-get-help; Get Help and Watch & Stay Current pages live under Community; Releases consolidated into a version table; Version Stamp Convention documented. The space looks materially different to a cold visitor than it did 24 hours ago.

Phases at a glance

Phase	Goal	Effort	Status

Phase	Goal	Effort	Status
1. IA Consolidation	32 lanes → 8 audience-aligned sections	~1 sprint	SUBSTANTIAL — folder moves remain
2. Start Here entry points	Landing page per audience with reading order + how to get help	~1 sprint	DONE
3. Content currency framework	Version stamps, consolidate Releases, archive meeting notes	~1 sprint	PARTIAL — convention + Releases table done
4. Customer ↔ community bridge	Get Help page, Recent Changes feed on homepage, Watch & Stay Current guide	~1 sprint	DONE — Recent Changes macro deferred
5. Content normalization	Page-type templates, decommission Google Doc anchors, native attachments, page convention	~1–2 sprints	QUEUED

Phase 1 — IA Consolidation

What's done

What's blocked (tool limitation)

The Atlassian connector's updateConfluencePage doesn't support Confluence's folder-typed objects — those return 404. Folders need a manual drag-and-drop in the Confluence UI. Manual move targets:

Estimated 5–10 minutes of UI work to complete Phase 1.

Phase 2 — Start Here entry points

For Lab Staff landing page — split paths for end users vs admins

For Implementers landing page — 5-step Plan→Install→Configure→Integrate→Train

For Developers landing page — onboarding + reference + contribution flow

For Operators landing page — runbook + upgrade + incident playbook

Modules & Features landing page — grouped index of 28+ feature pages

Releases landing page — version table with status lozenges + role-based subscription guide

Community landing page — get-help table + programs + contribution paths

Phase 3 — Content currency framework

Define version-stamp template — see Version Stamp Convention page under Community

Consolidate Past Releases + Older Releases + Current Production + Roadmap — the Releases page now shows a unified version table

Apply version stamps to all production reference pages — per-page editorial work, batch over time

Archive the 18 weekly 2025 meeting notes under Community/Archive/2025 — pending folder moves above

Phase 4 — Customer ↔ community bridge

Create Get Help page under Community — organized by need and by channel

Create Watch & Stay Current guide under Community — Confluence + GitHub + Talk subscriptions, by role

Add Get Help + Watch & Stay Current callouts to homepage

Add Recent Changes macro to homepage (deferred — needs Confluence macro insertion)

Phase 5 — Content normalization (longest tail, queued)

Establish 4 page-type templates (Concept / How-To / Reference / Tutorial)

Re-categorize every page into one of the four types

Decommission Google Doc anchor cross-references (~30 pages affected)

Backlog: migrate external blob/CDN images to Confluence-native attachments

Resolve smartlink-redirect pages (e.g. QA Framework → Playwright) — decide convention

Pages created or significantly updated by this revamp

Page	Status	Notes

Page	Status	Notes
Homepage (Start Here)	Rewritten	8-card audience layout + Get Help / Watch callouts
For Lab Staff	Created + full landing	Section page #1
For Implementers	Created + full landing	Section page #2
For Developers	Created + full landing	Section page #3
For Operators	Created + full landing	Section page #4
Modules & Features	Created + full landing	Section page #5
Releases	Created + version table	Section page #6; consolidated view
Community	Created + full landing	Section page #7
Get Help	Created	Under Community
Watch & Stay Current	Created	Under Community
Version Stamp Convention	Created	Under Community

Open questions / decisions

Same space (OEG) vs new clean space + migrate? Decided: same space, in-place reorg. Preserves bookmarks and page IDs.
French content: parallel "(Français)" section under Lab Staff, or separate space? Tentatively: parallel section.
Dev primers on lab processes (QA Narrative, Microbiology walk-through) — keep under Developers, or under Modules with a "for developers" prefix? Tentatively: under Developers / Onboarding for new contributors.

Suggested next session

Complete the manual folder moves listed in Phase 1 (~5–10 min of UI work).
Add the Recent Changes macro to the homepage in the Confluence UI.
Begin Phase 3 stamping pass — verify the End User Manual PARTS 1–16 against the live system, apply version stamps.
Phase 5 can be slotted in opportunistically; it's editorial, not structural.

📋 OEG Confluence Revamp — Workplan (2026-05-20)