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

chore: add additional component documentation for fast-foundation #3203

Merged
merged 19 commits into from
May 29, 2020

Conversation

chrisdholt
Copy link
Member

Description

This PR adds additional component documentation and basic usage examples for fast-foundation.

Issue type checklist

  • Chore: A change that does not impact distributed packages.
  • Bug fix: A change that fixes an issue, link to the issue above.
  • New feature: A change that adds functionality.

Is this a breaking change?

  • This change causes current functionality to break.

Process & policy checklist

  • I have added tests for my changes.
  • I have tested my changes.
  • I have updated the project documentation to reflect my changes.
  • I have read the CONTRIBUTING documentation and followed the standards for this project.

## Usage

```html
<fast-dialog id="simpleDialog" aria-label="Simple modal dialog" modal="true">
Copy link
Contributor

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.

Copy link
Member Author

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.

Copy link
Contributor

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">
Copy link
Contributor

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
Copy link
Collaborator

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"

Copy link
Member Author

Choose a reason for hiding this comment

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

exactly

@chrisdholt chrisdholt force-pushed the users/chhol/add-additional-component-documentation branch from d8e0070 to 497031d Compare May 29, 2020 21:20
@chrisdholt chrisdholt merged commit baff146 into master May 29, 2020
@chrisdholt chrisdholt deleted the users/chhol/add-additional-component-documentation branch May 29, 2020 22:22
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.

4 participants