Skip to content

docs: record the alternatives the editor substrate decision was chosen over - #191

Merged
Azganoth merged 1 commit into
mainfrom
docs/record-editor-substrate-alternatives
Aug 11, 2026
Merged

docs: record the alternatives the editor substrate decision was chosen over#191
Azganoth merged 1 commit into
mainfrom
docs/record-editor-substrate-alternatives

Conversation

@Azganoth

Copy link
Copy Markdown
Owner

Summary

  • Record the alternatives Use Milkdown Kit was chosen over, and the reasons, so the substrate decision can be revisited on its merits.
  • Add the two consequences that follow: the projection cost is the accepted price of the natively rendered objects, and the commitment is to ProseMirror with Milkdown supplying the schema, the remark bridge, and the plugin framework over it.

Related Issue

Refs #152

Verification

pnpm exec oxfmt --check docs/decisions.md

Notes

Completes the last unchecked exit criterion of the #152 spike, whose Outcome carries the evaluation and its evidence. No product behavior, architecture, or release scope changes, so no other owning document needs an update.

Use Milkdown Kit carried a rationale but no rejected alternatives, so the
most consequential technical decision in the project could not be revisited
on its merits.
@Azganoth Azganoth added the Documentation Improvements or additions to documentation label Aug 11, 2026
@Azganoth Azganoth self-assigned this Aug 11, 2026
@Azganoth
Azganoth enabled auto-merge (squash) August 11, 2026 02:02
@Azganoth
Azganoth merged commit c42d58f into main Aug 11, 2026
3 checks passed
@Azganoth
Azganoth deleted the docs/record-editor-substrate-alternatives branch August 11, 2026 02:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant