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 tooltip docs to add note about disabled #2084

Merged
merged 3 commits into from
Jun 20, 2023
Merged

Conversation

khiga8
Copy link
Contributor

@khiga8 khiga8 commented Jun 20, 2023

What are you trying to accomplish?

Documenting that tooltip should not be used with disabled.

List the issues that this change affects.

Follow up to Slack thread

Closes #2085

Risk Assessment

  • Low risk the change is small, highly observable, and easily rolled back.
  • Medium risk changes that are isolated, reduced in scope or could impact few users. The change will not impact library availability.
  • High risk changes are those that could impact customers and SLOs, low or no test coverage, low observability, or slow to rollback.

Anything you want to highlight for special attention from reviewers?

I noticed that the Accessibility section and the What type do I set information was not being rendered on the doc page for tooltip. I'm assuming this is due to the ongoing docs migration work, and we're only allowing top-level text.

I think this information is very important to surface so I opted to remove the headings to ensure it shows up in the doc.

Merge checklist

  • Added/updated tests
  • Added/updated documentation
  • Added/updated previews (Lookbook)
  • Tested in Chrome
  • Tested in Firefox
  • Tested in Safari
  • Tested in Edge

Take a look at the What we look for in reviews section of the contributing guidelines for more information on how we review PRs.

@khiga8 khiga8 requested review from a team and camertron June 20, 2023 16:45
@changeset-bot
Copy link

changeset-bot bot commented Jun 20, 2023

⚠️ No Changeset found

Latest commit: 13b4e6b

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 github-actions bot added the ruby Pull requests that update Ruby code label Jun 20, 2023
@khiga8 khiga8 added the skip changeset Pull requests that don't change the library output label Jun 20, 2023
# The majority of tooltips will fall under this category.
# - When there is no visible text on the trigger element and the tooltip content is appropriate as a label for the element, set `type: :label`.
# `label` type is usually only appropriate for an icon-only control.
#
Copy link
Contributor Author

Choose a reason for hiding this comment

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

I noticed that the "Accessibility" section and the "Which type do I set" information is not being rendered on the doc page for tooltip. I'm assuming this is due to the ongoing docs migration work, and we're only allowing top-level text to show up.

I think this information is very important to surface so I opted to remove the headings to ensure it shows up in the doc.

Copy link
Contributor

@camertron camertron Jun 20, 2023

Choose a reason for hiding this comment

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

Hmm that's interesting. I'll look into it. Ideally all markdown under the @accessibility tag should make it to the new docsite.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Thank you! Happy to add back the headings later!

@khiga8 khiga8 temporarily deployed to github-pages June 20, 2023 16:53 — with GitHub Actions Inactive
app/components/primer/alpha/tooltip.rb Outdated Show resolved Hide resolved
Co-authored-by: Cameron Dutro <camertron@gmail.com>
@khiga8
Copy link
Contributor Author

khiga8 commented Jun 20, 2023

Please merge whenever since I don't have merge authorization! Thank you!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
ruby Pull requests that update Ruby code skip changeset Pull requests that don't change the library output
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add note about use with disabled attribute
2 participants