Skip to content
John A. Paz edited this page Oct 2, 2026 · 3 revisions

johnapaz.com development wiki

This wiki records the requirements, decisions, development history, and operating context for johnapaz.com. It supports contributors, AI sessions, and future writing about how the site was built.

V2 launched — October 2, 2026

V2 is live on johnapaz.com from the renamed main branch. V2 launch records content, source and deployment evidence, staging/CI checks, recovery, and remaining work. Earlier production holds are superseded by John’s explicit launch authorization.

Start here

Page What it contains
Roadmap Phases, timeline, dependencies, and completion criteria
V2 requirements Current product and design requirements, exact approved copy, and open questions
Decision log Decisions, rationale, alternatives, and superseded choices
Architecture and configuration Verified implementation facts and configuration references
Development workflow Contributor and AI session protocol, staging, review, and release
Development journal Dated outcomes, experiments, evidence, and session handoffs

Live issue backlog · Source repository

How to use this record

Issues track actionable work and its live status. The wiki records context and rationale. Source files hold executable configuration. Link between them rather than maintaining competing copies of task lists or settings.

Read the relevant pages and linked issues at the start of a session. Preserve exact approved copy and distinguish proposed, accepted, and superseded decisions. Check actual source and service settings before treating configuration notes as current. Record material outcomes and the next step before ending a session.

The wiki is public: record configuration locations and ownership without credentials or private session transcripts.

Clone this wiki locally