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

Improve guideline documentation for business errors #8321

Merged
merged 4 commits into from
Apr 24, 2024

Conversation

twschiller
Copy link
Contributor

@twschiller twschiller commented Apr 23, 2024

What does this PR do?

  • Improve documentation / guidelines for business errors: clarify when to use BusinessError vs. Error subclass

Discussion

  • Call out any places where clarification would be helpful
  • Feel free to make commits, etc. directly to this PR

Checklist

  • Add jest or playwright tests and/or storybook stories: N/A
  • Designate a primary reviewer: @grahamlangford

@twschiller twschiller changed the title Improve documentation / guidelines for business errors Improve guideline documentation for business errors Apr 23, 2024
Copy link

codecov bot commented Apr 23, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 73.52%. Comparing base (cb5588c) to head (a892796).
Report is 16 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #8321      +/-   ##
==========================================
- Coverage   73.54%   73.52%   -0.02%     
==========================================
  Files        1330     1330              
  Lines       41019    41019              
  Branches     7601     7601              
==========================================
- Hits        30167    30160       -7     
- Misses      10852    10859       +7     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

* by the PixieBrix team
* - Business errors indicate a problem with user-defined content or 3rd party services. They must be addressed
* by the customer
* - Business errors are not reported to Datadog, but are reported to the PixieBrix error telemetry service
Copy link
Collaborator

Choose a reason for hiding this comment

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

A link here to some place that further describes or defines the Pixiebrix error telemetry service could be useful.

* An error indicating an invalid input was provided to a brick. Used for runtime checks that cannot be performed as
* part of JSONSchema input validation.
*
* Throwing PropError instead of BusinessError allows the Page Editor so show the error on the associated field
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
* Throwing PropError instead of BusinessError allows the Page Editor so show the error on the associated field
* Throwing PropError instead of BusinessError allows the Page Editor to show the error on the associated field

Copy link

No loom links were found in the first post. Please add one there if you'd like to it to appear on Slack.

Do not edit this comment manually.

@twschiller twschiller enabled auto-merge (squash) April 24, 2024 22:59
@twschiller twschiller added this to the 1.8.14 milestone Apr 24, 2024
@twschiller twschiller merged commit 0535e01 into main Apr 24, 2024
19 checks passed
@twschiller twschiller deleted the feature/business-error-docs branch April 24, 2024 23:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Development

Successfully merging this pull request may close these issues.

4 participants