-
Notifications
You must be signed in to change notification settings - Fork 600
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
chore: add additional component documentation for fast-foundation
#3203
chore: add additional component documentation for fast-foundation
#3203
Conversation
## Usage | ||
|
||
```html | ||
<fast-dialog id="simpleDialog" aria-label="Simple modal dialog" modal="true"> |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is there a way to embed fixtures into these documents? I worry about these getting out of sync and it would be awesome to just reference a fixture.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm sure we could copy them over somehow, but I'd want to scrub our fixtures and be sure they are always at a high quality. I lean a bit towards having these be a bit curated to start. This is even initial as I'm going to do a follow-up to try and have live-code examples as part of the readme.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We could have our build process copy the fixture content into a designated location in the markdown file.
## Usage | ||
|
||
```html | ||
<fast-dialog id="simpleDialog" aria-label="Simple modal dialog" modal="true"> |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We could have our build process copy the fixture content into a designated location in the markdown file.
@@ -4,6 +4,7 @@ title: fast-dialog | |||
sidebar_label: fast-dialog | |||
custom_edit_url: https://github.com/microsoft/fast-dna/edit/master/packages/web-components/fast-foundation/src/dialog/README.md | |||
--- | |||
A web component implementation of a [dialog](https://w3c.github.io/aria-practices/#dialog_modal) which can either be modal or non-modal. The modal |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Dangling sentence here? It just says "The modal"
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
exactly
packages/web-components/fast-foundation/src/text-field/README.md
Outdated
Show resolved
Hide resolved
d8e0070
to
497031d
Compare
Description
This PR adds additional component documentation and basic usage examples for fast-foundation.
Issue type checklist
Is this a breaking change?
Process & policy checklist