Skip to content

Improve docs consistency for Overlay, PageHead, Pagination, Popover, Portal, ProgressBar components #1805

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

Merged
merged 17 commits into from
Feb 1, 2022

Conversation

rezrah
Copy link
Contributor

@rezrah rezrah commented Jan 18, 2022

Part of #1701

Added / Updated docs for:

Merge checklist

  • Added/updated tests
  • Added/updated documentation
  • Tested in Chrome
  • Tested in Firefox
  • Tested in Safari
  • Tested in Edge

@rezrah rezrah added the skip changeset This change does not need a changelog label Jan 18, 2022
@changeset-bot
Copy link

changeset-bot bot commented Jan 18, 2022

⚠️ No Changeset found

Latest commit: 201400f

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

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

@github-actions
Copy link
Contributor

github-actions bot commented Jan 18, 2022

size-limit report 📦

Path Size
dist/browser.esm.js 61.64 KB (0%)
dist/browser.umd.js 62 KB (0%)

@rezrah rezrah changed the title Improve docs consistency for Overlay components Improve docs consistency for Overlay, PageHead components Jan 18, 2022
@rezrah rezrah changed the title Improve docs consistency for Overlay, PageHead components Improve docs consistency for Overlay, PageHead, Pagination components Jan 18, 2022
@rezrah rezrah changed the title Improve docs consistency for Overlay, PageHead, Pagination components Improve docs consistency for Overlay, PageHead, Pagination, Popover components Jan 18, 2022
@rezrah rezrah changed the title Improve docs consistency for Overlay, PageHead, Pagination, Popover components Improve docs consistency for Overlay, PageHead, Pagination, Popover, Portal components Jan 18, 2022
@rezrah rezrah marked this pull request as ready for review January 18, 2022 12:57
@rezrah rezrah requested review from a team and siddharthkp January 18, 2022 12:57
# - title: Overlay
# url: /Overlay
- title: Overlay
url: /Overlay
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Unclear why this was hidden. Does anyone know?

@rezrah rezrah changed the title Improve docs consistency for Overlay, PageHead, Pagination, Popover, Portal components Improve docs consistency for Overlay, PageHead, Pagination, Popover, Portal, ProgressBar components Jan 18, 2022
@rezrah rezrah requested a review from colebemis January 18, 2022 13:30
@@ -45,7 +49,7 @@ By default, clicking a link in the pagination component will cause the browser t
</State>
```

## Customizing link URLs
### Customizing link URLs
Copy link
Member

Choose a reason for hiding this comment

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

❤️

Copy link
Member

@siddharthkp siddharthkp left a comment

Choose a reason for hiding this comment

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

Love to see it! ❤️

Comment on lines +119 to +124
<PropsTableRow
name="as"
defaultValue="div"
type="string"
description="Sets the underlying HTML tag for the component"
/>
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
<PropsTableRow
name="as"
defaultValue="div"
type="string"
description="Sets the underlying HTML tag for the component"
/>
<PropsTableAsRow
defaultElementType="div"
/>

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Same comment as before, this suggestion results in an empty row? @colebemis

Comment on lines +24 to +29
<PropsTableRow
name="as"
defaultValue="div"
type="string"
description="Sets the underlying HTML tag for the component"
/>
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
<PropsTableRow
name="as"
defaultValue="div"
type="string"
description="Sets the underlying HTML tag for the component"
/>
<PropsTableAsRow
defaultElementType="div"
/>

Comment on lines +153 to +158
<PropsTableRow
name="as"
defaultValue="div"
type="string"
description="Sets the underlying HTML tag for the component"
/>
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
<PropsTableRow
name="as"
defaultValue="div"
type="string"
description="Sets the underlying HTML tag for the component"
/>
<PropsTableAsRow
defaultElementType="div"
/>

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@colebemis This doesn't seem to work with html tags, getting an empty row. Any ideas? Screenshot 2022-01-21 at 14 16 36

### ProgressBar

<PropsTable>
<PropsTableRow name="progress" type="number" description="Used to set the size of the green bar" />
Copy link
Contributor

Choose a reason for hiding this comment

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

Is this required?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

As in a required prop? No, it's optional. Defaults to 0 if it's not passed in.

Copy link
Contributor

@colebemis colebemis left a comment

Choose a reason for hiding this comment

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

🚢

@rezrah rezrah merged commit 63970fd into main Feb 1, 2022
@rezrah rezrah deleted the docs/update-component-docs-pt2-rez branch February 1, 2022 16:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
react skip changeset This change does not need a changelog
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants