Background
From the AI readiness audit (April 20, 2026). The docs have two parallel CLI sections that are unclear in their relationship:
/datumctl/* — 3 pages: overview, authentication, activity (conceptual guides)/cli/* — 16 pages: individual command reference (datumctl_apply, datumctl_get, etc.)
The sidebar shows these as separate navigation groups ("datumctl (CLI)" and "CLI Commands"). An AI crawler encountering both sections has no clear signal about how they relate — are they duplicates? Sequential? Different abstraction levels?
Fix
Content edit on /datumctl/overview — add a clear explanation such as:
The datumctl section covers concepts, authentication, and workflows. The CLI Commands section contains the full flag-level reference for each command.
This is a content clarification only — no structural navigation changes needed.
Background
From the AI readiness audit (April 20, 2026). The docs have two parallel CLI sections that are unclear in their relationship:
/datumctl/*— 3 pages: overview, authentication, activity (conceptual guides)/cli/*— 16 pages: individual command reference (datumctl_apply, datumctl_get, etc.)The sidebar shows these as separate navigation groups ("datumctl (CLI)" and "CLI Commands"). An AI crawler encountering both sections has no clear signal about how they relate — are they duplicates? Sequential? Different abstraction levels?
Fix
Content edit on
/datumctl/overview— add a clear explanation such as:/datumctl/overviewto explain the two-section structure/datumctl/overview→/cli/options/cli/options→/datumctl/overviewThis is a content clarification only — no structural navigation changes needed.