docs/blog marketing drafts and a commit-pinned docs/foundation copy live in the product repo #23

New Issue

2026-10-01T22:50:55Z

KofTwentyTwo commented

2026-10-01 22:50:55 +00:00

(Migrated from github.com)

Summary

docs/blog/ holds three draft articles plus a README that itself says to strip local paths before publishing. Marketing drafts in the product repository are easy to ship by accident.
docs/foundation/ is a copy of the foundation guides pinned to foundation commit d46cf4e (FOUNDATION-REFERENCE.md:3) rather than the 0.5.0-SNAPSHOT parent version; it is currently identical apart from link rewrites but will drift silently on the next parent bump.

Suggested resolution

Move the blog drafts out (or into a clearly non-shipped folder) and have the foundation generator refresh docs/foundation/ as part of a parent upgrade, recording the parent version instead of a commit.

Priority rationale

P3: housekeeping.

Filed from the 2026-10-01 real-versus-fake audit of Carl (branch feature/cicd-liquibase-gitops, HEAD 5414d7a, main 1b334d1). Four read-only reviews covered domain and services, QQQ metadata and data model, tests/CI/evidence, and docs/integrations. A local offline build of a Carl copy against the installed foundation 0.5.0-SNAPSHOT is in progress; its result will be added as a comment. Existing issues #3, #4 and #5 (real Monarch accounts, Authentik with real data, CI/CD with Liquibase and ArgoCD) are referenced rather than duplicated.

## Summary - `docs/blog/` holds three draft articles plus a README that itself says to strip local paths before publishing. Marketing drafts in the product repository are easy to ship by accident. - `docs/foundation/` is a copy of the foundation guides pinned to foundation commit `d46cf4e` (`FOUNDATION-REFERENCE.md:3`) rather than the `0.5.0-SNAPSHOT` parent version; it is currently identical apart from link rewrites but will drift silently on the next parent bump. ## Suggested resolution Move the blog drafts out (or into a clearly non-shipped folder) and have the foundation generator refresh `docs/foundation/` as part of a parent upgrade, recording the parent version instead of a commit. ## Priority rationale P3: housekeeping. --- Filed from the 2026-10-01 real-versus-fake audit of Carl (branch `feature/cicd-liquibase-gitops`, HEAD `5414d7a`, main `1b334d1`). Four read-only reviews covered domain and services, QQQ metadata and data model, tests/CI/evidence, and docs/integrations. A local offline build of a Carl copy against the installed foundation 0.5.0-SNAPSHOT is in progress; its result will be added as a comment. Existing issues #3, #4 and #5 (real Monarch accounts, Authentik with real data, CI/CD with Liquibase and ArgoCD) are referenced rather than duplicated.

This repo is archived. You cannot comment on issues.

1 Participants

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: KofTwentyTwo/carl#23