Skip to content

docs: Type system refinements and PostgreSQL notebook fix #133

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
dimitri-yatsenko wants to merge 4 commits into
base: main
Choose a base branch
from
Open

docs: Type system refinements and PostgreSQL notebook fix #133

dimitri-yatsenko wants to merge 4 commits into from

Conversation

@dimitri-yatsenko
Copy link
Member

@dimitri-yatsenko dimitri-yatsenko commented Jan 21, 2026 •
edited
Loading

Summary

  • Improved type system documentation with historical context and cross-references
  • Fixed PostgreSQL compatibility issue in allen-ccf tutorial notebook

Changes

Type System Documentation (src/explanation/type-system.md)

  • Mark <filepath@> addressing as "User-managed" in Built-in Codecs table
  • Add historical context for <blob> type (15+ years backward compatibility)
  • Add callout explaining schema-addressed codecs as modern alternatives
  • Add "See Also" section with cross-references to how-tos and specs

Tutorial Fix (src/tutorials/domain/allen-ccf/allen-ccf.ipynb)

  • Fix SQL LIKE pattern to use single quotes for PostgreSQL compatibility
  • Re-executed notebook against PostgreSQL and saved outputs

Test plan

  • Type system page renders correctly
  • All cross-reference links work
  • Allen-ccf notebook executes successfully against PostgreSQL

🤖 Generated with Claude Code

dimitri-yatsenko and others added 4 commits January 21, 2026 14:39
@dimitri-yatsenko
docs: Mark <filepath@> addressing as User-managed
578067e
@dimitri-yatsenko @claude
docs: Add historical context for <blob> and contrast with modern codecs
32fe8ed 
- Note 15+ years of backward-compatible use in DataJoint pipelines
- Add callout explaining schema-addressed codecs as modern alternatives
  with transparent formats, lazy loading, and browsable paths

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@dimitri-yatsenko
docs: Add See Also section with cross-references to how-tos and specs
efa520a
@dimitri-yatsenko @claude
fix: Use single quotes in SQL LIKE pattern for PostgreSQL compatibility
61e257e 
Changed restriction string from double quotes to single quotes in the
Visual regions query. PostgreSQL uses single quotes for string literals.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@dimitri-yatsenko dimitri-yatsenko changed the title WIP: docs: Type system refinements docs: Type system refinements and PostgreSQL notebook fix Jan 21, 2026
@dimitri-yatsenko dimitri-yatsenko marked this pull request as ready for review January 21, 2026 21:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@MilagrosMarin MilagrosMarin Awaiting requested review from MilagrosMarin

At least 1 approving review is required to merge this pull request.

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@dimitri-yatsenko