Skip to content

[codex] Deepen core concepts docs#116

Draft
abegong wants to merge 19 commits into
mainfrom
codex/deepen-core-concepts-docs
Draft

[codex] Deepen core concepts docs#116
abegong wants to merge 19 commits into
mainfrom
codex/deepen-core-concepts-docs

Conversation

@abegong

@abegong abegong commented Jun 25, 2026

Copy link
Copy Markdown
Owner

Summary

  • Expands the Core concepts deep dive from a WIP sketch into a fuller orientation page.
  • Adds a concept map showing how projects, storage, collections, items, attributes, operations, checks, and inspectors relate.
  • Documents the catalog -> define -> enforce -> reshape workflow and links the page back to the related deep dives.

Validation

  • ./bin/katalyst check
  • make docs-build

./bin/katalyst check passed with existing writing-tell warnings elsewhere in the docs corpus; the edited page reported OK.

@netlify

netlify Bot commented Jun 25, 2026

Copy link
Copy Markdown

Deploy Preview for stately-starburst-216875 ready!

Name Link
🔨 Latest commit 57ab7a5
🔍 Latest deploy log https://app.netlify.com/projects/stately-starburst-216875/deploys/6a3d964a06a37a0008531ae1
😎 Deploy Preview https://deploy-preview-116--stately-starburst-216875.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@abegong abegong force-pushed the codex/deepen-core-concepts-docs branch from 5114980 to c85a3a9 Compare June 25, 2026 13:23
Abe Gong and others added 19 commits June 25, 2026 14:39
Rework the deep-dive narrative around the core concepts and replace the diagram asset, then constrain the diagram width so it no longer spans the full content column.

Co-authored-by: Cursor <cursoragent@cursor.com>
Clarify the deep-dive around base capabilities, raw versus collection-configured content, and operation scope while updating the supporting diagram and reusable docs image styling.

Co-authored-by: Cursor <cursoragent@cursor.com>
Clarify that collectionized configuration builds on raw access and update the storage-layer narrative and section structure to match that progression.

Co-authored-by: Cursor <cursoragent@cursor.com>
Introduce a toc-before partial that renders a right-panel warning from page frontmatter so stale or accuracy notes can be shown on a document-by-document basis.

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Abe Gong <abe@Abes-MacBook-Air.local>
@abegong abegong force-pushed the codex/deepen-core-concepts-docs branch from 20b9a6c to 57ab7a5 Compare June 25, 2026 20:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant