Skip to content

Conversation

@dimitri-yatsenko
Copy link
Member

Summary

Fixes terminology inconsistency identified in comprehensive cohesion review (COHESION-REVIEW.md Issue #1).

Problem

TERMINOLOGY.md explicitly deprecates "inline storage" → "in-table storage", but several documentation files still used the old term, undermining the authoritative terminology reference.

Changes

Replaced all occurrences of deprecated storage terminology:

Files Changed

  • how-to/use-object-storage.md:

    • "stored inline" → "stored in-table"
    • "Inline vs Object Store" → "In-Table vs Object Store"
    • Comment: "# Inline: stored in database" → "# In-table: stored in database"
  • reference/specs/type-system.md:

    • "vs inline in database" → "vs in-table" (2 occurrences)
    • "Inline storage (database column)" → "In-table storage (database column)"
  • reference/specs/codec-api.md:

    • Comment: "# inline storage" → "# in-table storage"
    • Comment: "# Different behavior for inline/store" → "# in-table/store"
  • reference/specs/npy-codec.md:

    • "Cannot store inline in the database column" → "Cannot store in-table (database column)"
  • explanation/whats-new-2.md:

    • "inline attachment" → "in-table attachment" (historical context)
  • llms-full.txt: Regenerated to pick up all fixes

Verification

grep -rn "inline storage\|inline attachment\|inline in database" src/ --include="*.md"
# Result: No deprecated inline terminology found in markdown files!

Impact

  • Establishes consistency with authoritative TERMINOLOGY.md
  • Prevents user confusion from mixed terminology
  • No breaking changes - pure documentation clarification

Related

  • Addresses COHESION-REVIEW.md Issue Mkdocs #1 (High Priority)
  • Part of comprehensive documentation cohesion improvements

- Fixed llms.txt manual reference from migrate-from-0x to migrate-to-v20
- Regenerated llms-full.txt to pick up all corrected migration guide links from PR #107
- Verified no remaining broken internal links in LLM documentation files
…erminology

Fixed terminology inconsistency identified in cohesion review:
- TERMINOLOGY.md explicitly deprecates 'inline storage' → 'in-table'
- Updated all documentation to use canonical terminology

Files changed:
- how-to/use-object-storage.md: inline → in-table (3 occurrences)
- reference/specs/type-system.md: inline → in-table (3 occurrences)
- reference/specs/codec-api.md: inline → in-table (2 occurrences)
- reference/specs/npy-codec.md: inline → in-table (1 occurrence)
- explanation/whats-new-2.md: inline attachment → in-table attachment
- llms-full.txt: regenerated to pick up all fixes

Verified: No deprecated inline storage terminology remains in markdown files.

Fixes: COHESION-REVIEW.md Issue #1 (High Priority)
@dimitri-yatsenko
Copy link
Member Author

Consolidated into #119 - Documentation Cohesion Review: Comprehensive Improvements for DataJoint 2.0

@dimitri-yatsenko dimitri-yatsenko deleted the fix/terminology-inline-to-in-table branch January 14, 2026 23:14
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.

2 participants