Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update component descriptions and associated declaration #108

Merged
merged 13 commits into from
Jul 19, 2024

Conversation

benkates
Copy link
Contributor

@benkates benkates commented Jul 12, 2024

What's in this pull request

  • Documentation update

Description

Among other tasks, the main purpose of this PR is to update the way in which long, html-based descriptions are being imported into .stories. Other tasks include:

  • Add import instructions for each component
  • Chore: remove description field from top level meta object (doesn't render)
  • Update PR template checklist with new workflow check
  • Updating instances of code chunks formatted with html instead of svelte

Before submitting, please check that you've

  • Formatted your code correctly (i.e., prettier cleaned it up)
  • Documented any new components or features
  • Added any changes in this PR to the CHANGELOG.md Next section

@benkates benkates marked this pull request as ready for review July 18, 2024 20:46
@benkates benkates requested a review from mitchthorson July 18, 2024 20:46
Copy link
Contributor

@mitchthorson mitchthorson left a comment

Choose a reason for hiding this comment

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

Many thanks for all of this! Left one comment for optional consideration, but this looks great.

@@ -17,3 +17,4 @@ Tell us what this PR does or link to any related issues that describe the goal h
- [ ] Added any changes in this PR to the `CHANGELOG.md` `Next` section
- [ ] If this pull request includes a new component or feature, has it been exported from one of the library's entry points?
- [ ] Does the component dispatch relevant interaction events? (ie: on:click, on:change, etc.)
- [ ] Does the component directory include a separate `.docs.md` imported into `.stories.svelte` for description and usage information?
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested tweak: Make this language more specific about including "description and usage information" but maybe leave out the import seperate .docs.md ? I'm thinking about cases where a component needs custom mdx docs for more robust formats (See maps/SVGMap/SVGMap.docs.mdx) where this might not apply.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Just updated! Let me know what you think.

Copy link
Contributor

@mitchthorson mitchthorson left a comment

Choose a reason for hiding this comment

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

perfect!

@benkates benkates merged commit 156c0b1 into main Jul 19, 2024
1 check passed
@benkates benkates deleted the patch-storybook-descriptions branch July 19, 2024 18:00
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