DOCS-134 review #4
Merged
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Mostly I did small edits in place that clarify distinctions between values, objects/documents. In a couple of cases, there are larger changes I wasn't sure how you'd want to handle, so I marked them with TODO and made some comments.
While all the docs have been changed to use the shell's db..aggregate() shortcut, we should have something at the top of the reference that shows how to do this via db.runCommand(). Apparently the driver owners only just found out yesterday that they should be implementing this shortcut, and I'm worried not all of them will have it soon after 2.2 is released. Therefore, we should show the alternate command form so that users whose driver doesn't have the shortcut will know what to do. This has already come up, where users are now asking how to aggregate in drivers that have not been released with the shortcut.