Documentation use of "#### Example:" and "#### Examples:"

[hasezoey]

Currently many jsdoc comments use either Examples: or Example:, not regarding how many examples there are, should this maybe be changed to be consistent to just Example: (or something else)?

Some Examples:

mongoose/lib/aggregate.js

Lines 243 to 250 in 2de1a86

	/**
	* Appends a new custom $group operator to this aggregate pipeline.
	*
	* #### Examples:
	*
	* aggregate.group({ _id: "$department" });
	*
	* @see $group https://docs.mongodb.org/manual/reference/aggregation/group/

mongoose/lib/aggregate.js

Lines 156 to 174 in 2de1a86

	/**
	* Appends a new $addFields operator to this aggregate pipeline.
	* Requires MongoDB v3.4+ to work
	*
	* #### Examples:
	*
	* // adding new fields based on existing fields
	* aggregate.addFields({
	* newField: '$b.nested'
	* , plusTen: { $add: ['$val', 10]}
	* , sub: {
	* name: '$a'
	* }
	* })
	*
	* // etc
	* aggregate.addFields({ salary_k: { $divide: [ "$salary", 1000 ] } });
	*
	* @param {Object} arg field specification

mongoose/lib/aggregate.js

Lines 89 to 101 in 2de1a86

	/**
	* Get/set the model that this aggregation will execute on.
	*
	* #### Example:
	*
	* const aggregate = MyModel.aggregate([{ $match: { answer: 42 } }]);
	* aggregate.model() === MyModel; // true
	*
	* // Change the model. There's rarely any reason to do this.
	* aggregate.model(SomeOtherModel);
	* aggregate.model() === SomeOtherModel; // true
	*
	* @param {Model} [model] Set the model associated with this aggregate. If not provided, returns the already stored model.

mongoose/lib/aggregate.js

Lines 20 to 45 in 2de1a86

	/**
	* Aggregate constructor used for building aggregation pipelines. Do not
	* instantiate this class directly, use [Model.aggregate()](/docs/api.html#model_Model-aggregate) instead.
	*
	* #### Example:
	*
	* const aggregate = Model.aggregate([
	* { $project: { a: 1, b: 1 } },
	* { $skip: 5 }
	* ]);
	*
	* Model.
	* aggregate([{ $match: { age: { $gte: 21 }}}]).
	* unwind('tags').
	* exec(callback);
	*
	* #### Note:
	*
	* - The documents returned are plain javascript objects, not mongoose documents (since any shape of document can be returned).
	* - Mongoose does **not** cast pipeline stages. The below will **not** work unless `_id` is a string in the database
	*
	* new Aggregate([{ $match: { _id: '00000000000000000000000a' } }]);
	* // Do this instead to cast to an ObjectId
	* new Aggregate([{ $match: { _id: new mongoose.Types.ObjectId('00000000000000000000000a') } }]);
	*
	* @see MongoDB https://docs.mongodb.org/manual/applications/aggregation/

PS: this is a discussion because i would like to change it to be consistent, but would like to know what to change it to before doing it

[vkarpov15]

I think switching to consistent Example: is fine.

[hasezoey]

created PR #12432