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: improve documentation consistency #241

Merged
merged 1 commit into from
Aug 1, 2023

Conversation

clintcs
Copy link
Contributor

@clintcs clintcs commented Jul 31, 2023

🚀 Description

  • Add "Optional" descriptors to argument documentation that is missing them
  • Move required-argument documentation above optional-argument documentation
  • Break down multi-sentence documentation into multiple lines for easier editing and easier raw reading

🔬 How to Test


As long as the build is green, we're probably good.

@changeset-bot
Copy link

changeset-bot bot commented Jul 31, 2023

🦋 Changeset detected

Latest commit: 1eda28b

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages
Name Type
@crowdstrike/ember-toucan-core Patch
@crowdstrike/ember-toucan-form Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@github-actions
Copy link
Contributor

github-actions bot commented Jul 31, 2023

Preview URLs

Env: preview
Docs: https://ca15aca9.ember-toucan-core.pages.dev

@@ -199,7 +210,8 @@ Individual checkboxes can be set to read only by setting the `@isReadOnly` argum

## Attributes and Modifiers

Copy link
Contributor Author

@clintcs clintcs Jul 31, 2023

Choose a reason for hiding this comment

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

Should "Attributes and Modifier" sections also have an "Optional" descriptor?

Copy link
Contributor

Choose a reason for hiding this comment

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

I think that makes sense, as they are not "required" 🎉

@@ -2,12 +2,6 @@

Provides an underlying `<input type="file">` element building on top of the Field component.

## Accepts
Copy link
Contributor Author

@clintcs clintcs Jul 31, 2023

Choose a reason for hiding this comment

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

Moved below the label argument (required) documentation.

@clintcs clintcs marked this pull request as ready for review July 31, 2023 18:15
@clintcs clintcs requested a review from ynotdraw July 31, 2023 18:16
@@ -199,7 +210,8 @@ Individual checkboxes can be set to read only by setting the `@isReadOnly` argum

## Attributes and Modifiers

Copy link
Contributor

Choose a reason for hiding this comment

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

I think that makes sense, as they are not "required" 🎉

@clintcs clintcs merged commit 1c1d185 into main Aug 1, 2023
14 checks passed
@clintcs clintcs deleted the improve-documentation-consistency branch August 1, 2023 13:23
@github-actions github-actions bot mentioned this pull request Aug 1, 2023
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.

2 participants