Document the updated syntax for the $out aggregation stage. The specific syntax has changed between 4.1.1 and 4.1.2, with additional functionality added in 4.1.3. Some functionality may have been backported to 4.0.x. Check the corresponding server ticket for each $out related change to look for any backport work done.
The current syntax for $out is:
WRITING-1983 contains significant amounts of behavioral descriptions that should be taken into account when updating the current $out page. Take special care when documenting the behavior of uniqueKey.
SERVER-36123, $out does not support outputting to a sharded collection if mode : "replaceCollection
SERVER-18027, $out does support outputting to a sharded collection if mode : "insertDocuments|replaceDocuments"
Other tickets may come through related to additional behavior of $out. There's some confusion over exactly what versions behavior has been ported to. Focus on what is going into 4.2, but make note of any features (e.g.
SERVER-36123) that have been marked with a 4.0.x fix version. Confirm with the engineers what features specifically will/have been backported, if any.
See https://jira.mongodb.org/browse/PM-828 for a complete list of all tickets related to $out
- You can find the source file in source/reference/operator/aggregation/out.txt
- Use https://docs.mongodb.com/manual/reference/operator/aggregation/lookup/ as a model to work off of
- You can find the source file in source/reference/operator/aggregation/lookup.txt. Take note of how we use .. include:: directive and the files it points to, how they are structured, etc.