Skip to content

🎯 Core Node Types and Naming Conventions#3

Merged
rowanc1 merged 4 commits intomainfrom
rfc0003
Mar 24, 2026
Merged

🎯 Core Node Types and Naming Conventions#3
rowanc1 merged 4 commits intomainfrom
rfc0003

Conversation

@rowanc1
Copy link
Copy Markdown
Member

@rowanc1 rowanc1 commented Feb 3, 2026

This opens up the initial nodes. I have opted not to talk about a document/root type yet (maybe a mistake?). I am hoping these are not controversial. The naming convention needs some review, I went back and forth and don't quite remember the conversations in November or where we landed.

@rowanc1 rowanc1 requested a review from nokome February 3, 2026 01:45
@rowanc1 rowanc1 added the draft An RFC pull request in draft. label Feb 3, 2026
@github-actions
Copy link
Copy Markdown

github-actions bot commented Feb 3, 2026

Curvenote Preview

Directory Preview Checks Updated (UTC)
content/RFC0003 🔍 Inspect 11 checks passed (2 optional) Mar 24, 2026, 6:25 PM

Copy link
Copy Markdown

@tarleb tarleb left a comment

Choose a reason for hiding this comment

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

Thumbs up from here 👍

I'd like to throw out there the idea of renaming Code to CodeListing, just because that seems like a nice name and would keep naming closer to HTML. But I also like the "blocks first" naming convention.

Copy link
Copy Markdown

@nokome nokome left a comment

Choose a reason for hiding this comment

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

This looks great @rowanc1. Looking forward to implementing these and minting a new version of the oxa packages with them in it.

- **Emphasis**
- **Strong**
- **Superscript**
- **Subscript**
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

We could also include Strikethrough/Strikeout and Underline. Although they are slightly more contentious.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Lets punt those to a new RFC. Going to do an implementation for this for now.


Excluding these nodes at this stage is a deliberate choice to keep the initial core small, stable, and easy to implement.

## Naming Conventions and Design Trade-offs
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

This is an excellent, well-considered, section. Thank you!

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Awesome.

@tarleb I am going to add that we considered CodeListing / Code, but going to take your thumbs up!! :)

@rowanc1 rowanc1 added active An active RFC and removed draft An RFC pull request in draft. labels Mar 24, 2026
@rowanc1
Copy link
Copy Markdown
Member Author

rowanc1 commented Mar 24, 2026

I am going to move this one forward. RFCs are editable (keeping the same scope) so we could always revisit...!

@rowanc1 rowanc1 merged commit 898d817 into main Mar 24, 2026
8 checks passed
@rowanc1 rowanc1 deleted the rfc0003 branch March 24, 2026 18:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

active An active RFC

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants