Skip to content

Conversation

jamesnw
Copy link
Contributor

@jamesnw jamesnw commented Jul 2, 2025

This is a draft of the code style guidelines. It is intentionally a skeleton, with individual decisions happening as subsequent PRs.

For instance, #21 builds off of this to define a namespace, and all conversation related to that will happen in that PR.

In our call, we decided that as we build this out, these pull requests will be open for a week, with the hope that is enough time for people to review and discuss. They can also be action items in the weekly meeting.

It draws heavily from @bradfrost's document at https://vanilla-full.netlify.app/?path=/docs/documentation-guidelines--docs. Also, thanks to @gfellerph for feedback on an earlier draft.

Addresses #13


### Events

TODO
Copy link
Contributor Author

Choose a reason for hiding this comment

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

I think there are likely others in this group who have thought through the event and method naming conventions more than I have, and would welcome their input on what should be in a guidelines document.

Copy link
Collaborator

@gfellerph gfellerph left a comment

Choose a reason for hiding this comment

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

Thank you for writing this up! I'm leaving a couple of comments for discussion, therefore I'm submitting this just as comments and not a change request because I don't think any of it would be blocking.

jamesnw and others added 2 commits July 8, 2025 13:20
Co-authored-by: Philipp Gfeller <1659006+gfellerph@users.noreply.github.com>
@jamesnw jamesnw changed the title Add component API docs [ CodeStyle ] Add base code style guidelines Aug 26, 2025
@bradfrost bradfrost merged commit d9e4d77 into openui:main Aug 26, 2025
@bradfrost
Copy link
Collaborator

@jamesnw Let's get this file merged in, and then we can add PRs for some of the specifics.

@jamesnw jamesnw deleted the docs branch August 26, 2025 18:34
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.

3 participants