[DOCS-14607] [SERVER] Investigate changes in SERVER-58076: Exclude new language features from stable API for 1 quarter Created: 29/Jun/21  Updated: 13/Nov/23  Resolved: 28/Oct/21

Status: Closed
Project: Documentation
Component/s: manual, Server
Affects Version/s: None
Fix Version/s: 5.0.0-rc6, 5.1.0-rc0, Server_Docs_20231030, Server_Docs_20231106, Server_Docs_20231105, Server_Docs_20231113

Type: Task Priority: Major - P3
Reporter: Backlog - Core Eng Program Management Team Assignee: Unassigned
Resolution: Works as Designed Votes: 0
Labels: api-versioning
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Documented
documents SERVER-58076 Exclude new language features from st... Closed
Related
Participants:
Days since reply: 2 years, 14 weeks, 6 days ago
Epic Link: DOCSP-14300

 Description   

Description

Downstream Change Summary

Any new language feature introduced in 5.0 will not be included in API Version "1" to give us time to incorporate any feedback and fix any accidental semantic bugs like that in SERVER-57914.

We intend to add all these features in a future release, probably version 5.1. The list includes the following expressions:
$getField
$setField
$dateAdd
$dateSubtract
$dateTrunc

It also includes $setWindowFields and all window functions, which were already decided to be excluded during the beta program for time series.

Description of Linked Ticket

After SERVER-57914 was filed and described an improvement to an API we just released and did not exclude from API Version 1, we realized this is likely to be a recurring problem. To avoid tying ourselves to our first attempt at any new operator, we should make a standard of delaying "stability" for at least one quarterly release.

Scope of changes

Impact to Other Docs

MVP (Work and Date)

Resources (Scope or Design Docs, Invision, etc.)



 Comments   
Comment by Jeffrey Allen [ 28/Oct/21 ]

The list of supported API V1 commands is available here: https://docs.mongodb.com/manual/reference/versioned-api/#api-v1-commands

Therefore, I think we can close this as "Works as Designed". Note that there is a larger effort around updating each database command page to indicate versioned API compatibility. See DOCSP-18304.

Generated at Thu Feb 08 08:10:46 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.