dd_id_e5d4c3b2a1
Special
ADR-0001: DevDocs To WordPress Via Single Payload File
Table of Contents
Date: 2026-02-15
Context
DevDocs are authored in this repo (docs/devdocs/) and published to a separate WordPress site. We want a simple pipeline with minimal moving parts and an exact mirror of the current DevDocs pages in WordPress.
Decision
- A local Python script transforms all DevDocs markdown files into one prepared JSON payload file:
server/var_www/devdocs_wp/wp_bulk_payload.json. - That prepared payload file is synced to the server at
/var/www/devdocs_wp/wp_bulk_payload.json. - A WordPress plugin imports the payload and makes WordPress match the payload:
- Create new pages if they do not exist yet.
- Update existing pages only if their per-page hash changed.
- Permanently delete pages that no longer exist in DevDocs (not trash).
Consequences
- No server-side build scripts are needed.
- WordPress reads only the prepared payload file as input.
- Deletions are immediate and permanent; recovery requires restoring the source page and re-publishing.