Skip to content

[codex] Deepen core concepts docs#116

Merged
abegong merged 19 commits into
mainfrom
codex/deepen-core-concepts-docs
Jun 26, 2026
Merged

[codex] Deepen core concepts docs#116
abegong merged 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 42b3458
🔍 Latest deploy log https://app.netlify.com/projects/stately-starburst-216875/deploys/6a3eeeb4ae12ac00080dd346
😎 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 2 times, most recently from 20b9a6c to 57ab7a5 Compare June 25, 2026 20:57
@abegong abegong marked this pull request as ready for review June 26, 2026 16:16
Abe Gong and others added 19 commits June 26, 2026 15:24
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 57ab7a5 to 42b3458 Compare June 26, 2026 21:27
@abegong abegong merged commit 34d11fb into main Jun 26, 2026
6 checks passed
@abegong abegong deleted the codex/deepen-core-concepts-docs branch June 26, 2026 21:36
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