Skip to content

[ CodeStyle ] Add base code style guidelines#19

Merged
bradfrost merged 6 commits into
openui:mainfrom
jamesnw:docs
Aug 26, 2025
Merged

[ CodeStyle ] Add base code style guidelines#19
bradfrost merged 6 commits into
openui:mainfrom
jamesnw:docs

Conversation

@jamesnw

@jamesnw jamesnw commented Jul 2, 2025

Copy link
Copy Markdown
Contributor

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

Comment thread docs/component-api.md Outdated

### Events

TODO

Copy link
Copy Markdown
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.

Comment thread docs/component-api.md Outdated

@gfellerph gfellerph left a comment

Copy link
Copy Markdown
Collaborator

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.

Comment thread docs/component-api.md Outdated
Comment thread docs/component-api.md Outdated
Comment thread docs/component-api.md Outdated
Comment thread docs/component-api.md Outdated
Comment thread docs/component-api.md Outdated
Comment thread docs/component-api.md Outdated
Comment thread docs/component-api.md Outdated
jamesnw and others added 2 commits July 8, 2025 13:20
Co-authored-by: Philipp Gfeller <1659006+gfellerph@users.noreply.github.com>
Comment thread docs/component-api.md Outdated
@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
Copy Markdown
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