Skip to content

Conversation

@bashbaug
Copy link
Contributor

This is a PR to partially address the way we document error conditions, see #1320 and in particular #1320 (comment).

This doesn't modify the entire spec, but:

  • It's already a very large PR.
  • I think it's a nice improvement over what we have currently.

We should decide whether we merge these changes in their partial state or whether we wait to review and merge the changes for the entire spec in the same PR.

Regardless, it would be beneficial to decide what to do with this PR sooner rather than later, because any changes to error conditions will likely result in merge conflicts that will need to be resolved.

@bashbaug
Copy link
Contributor Author

Now that v3.0.19 is published I'd like to start getting these changes over the finish line. Would it be helpful to break this PR into smaller pieces? If so, what is the right size?

One PR per API is probably a bit too fine-grained since there are over 100 APIs. Maybe one PR per "chapter"? Or, is this PR tractable as-is, and folks just need a bit more time for review?

@bashbaug
Copy link
Contributor Author

I'll break this PR into smaller pieces for easier review. Moving to "draft" so it doesn't get accidentally merged.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Development

Successfully merging this pull request may close these issues.

1 participant