Skip to content

Update Reified Relation Documentation#756

Open
mdroidian wants to merge 1 commit intomainfrom
codex/linear-mention-eng-1405-update-reified-relation-documentat
Open

Update Reified Relation Documentation#756
mdroidian wants to merge 1 commit intomainfrom
codex/linear-mention-eng-1405-update-reified-relation-documentat

Conversation

@mdroidian
Copy link
Contributor

@mdroidian mdroidian commented Feb 9, 2026

Motivation

  • Introduce comprehensive documentation for the new stored (reified) relations feature and provide clear migration guidance from pattern-based relations.
  • Surface the new docs in the Roam documentation navigation so users can discover stored relations and migration guidance easily.
  • Inform users that pattern-based relations are being deprecated and point them to the new stored relations workflow and migration instructions.

Description

  • Added apps/website/app/(docs)/docs/roam/pages/reified-relations.md which documents stored relations, multi-user behavior, implementation notes, and future direction.
  • Added apps/website/app/(docs)/docs/roam/pages/migration-to-stored-relations.md which describes the migration flow, mixed-mode behavior, and edge cases.
  • Updated apps/website/app/(docs)/docs/roam/navigation.ts to expose links for reified-relations and migration-to-stored-relations in the Roam docs navigation.
  • Inserted deprecation notices into creating-discourse-relationships.md and relations-patterns.md and fixed internal cross-links to ./discourse-context-overlay and between the stored relations and migration pages.

Testing

  • No automated tests were run because these are documentation-only changes.

Codex Task


Open with Devin

@linear
Copy link

linear bot commented Feb 9, 2026

@supabase
Copy link

supabase bot commented Feb 9, 2026

This pull request has been ignored for the connected project zytfjzqyijgagqxrzbmz because there are no changes detected in packages/database/supabase directory. You can change this behaviour in Project Integrations Settings ↗︎.


Preview Branches by Supabase.
Learn more about Supabase Branching ↗︎.

@mdroidian mdroidian requested a review from jsmorabito February 9, 2026 00:08
Copy link
Contributor

@devin-ai-integration devin-ai-integration bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 4 additional findings.

Open in Devin Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant