[DRIVERS-2626] Better clarify schema version changes Created: 11/May/23 Updated: 21/Sep/23 |
|
| Status: | Backlog |
| Project: | Drivers |
| Component/s: | Unified Test Runner |
| Fix Version/s: | None |
| Type: | Task | Priority: | Minor - P4 |
| Reporter: | Jeremy Mikola | Assignee: | Unassigned |
| Resolution: | Unresolved | Votes: | 0 |
| Labels: | None | ||
| Remaining Estimate: | Not Specified | ||
| Time Spent: | Not Specified | ||
| Original Estimate: | Not Specified | ||
| Issue Links: |
|
||||||||
| Driver Changes: | Not Needed | ||||||||
| Description |
Summarymongodb/specifications@a9096ad for That commit neglected to clean up all references to the spec version. For example, Impact of Spec Changes on Schema Version still reads as if it's talking about the spec version. Take a pass through Schema Version and ensure that requirements for bumping the schema version are clearly communicated. For example, we should note how adding operations does not impact the schema version since operations are not modeled in the JSON schema. The addition of entities may entail a bump to the schema version depending on whether new syntax is introduced (not the case with entities that are only created by operations, such as createFindCursor). Additionally, add a Design Rationale to note what is and is not covered by the schema, and explain why some things like operations/arguments are intentionally unmodeled. This came up from a discussion in mongodb/specifications#1412 for DRIVERS-2533. MotivationWho is the affected end user?Spec test authors. How does this affect the end user?Users may have an incomplete understanding of how spec test changes impact the schema version. Is this issue urgent?No. Is this ticket required by a downstream team?No. Is this ticket only for tests?Yes. |