fix: update documentation of custom _id overriding in discriminators #8591
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.
Summary
This fixes Issue 8588 which appears to be an artifact in the documentation from before this fix to how the discriminator code handled a custom _id in the base schema. As I understand it, in the old code the implicit discriminator schema would still override the base, unless _id was set to 'false' in the discriminator options. This is what the old documentation still reflects (at least in part). However, it appears that now a custom base _id always overrides the discriminator _id. This updates the documentation to reflect that behavior.
Examples
This is a test file. The tests still run correctly--it was just the descriptions that didn't match.