Replace incorrect usage of "ordering" with "order"

[ad-si]

No description provided.

[tdammers]

I don't agee with all of these, but the choice between "order" and "ordering" is kind of subtle. We have to distinguish 3 usages:

• "order" (verb) - to put things in a certain order
• "ordering" (noun) - the process of putting things in a certain order
• "order" (noun) - the order in which certain things are arranged

In other words, "order" can either be a verb, referring to the process of arranging items relative to one another, or it can be a noun, referring to how item are positioned relative to one another. "Ordering", the gerund of "order", used as a noun, refers to the process, just like the verb.

Now, the configuration key is named order, and it is supposed to be a verb, just like fetch; e.g., order: name means "order the result set by name". Not, "the order of the result set is name". But when we refer to the effect of the configuration setting as a noun, "ordering" is more accurate, because we are not describing a situation, we are requesting an operation.

So:

• The configuation key should remain order.
• All references to the actual configuration key (easily recognizable, being typeset as code) should be changed to order.
• All prose descriptions in documentation should keep using the word "ordering", unless they describe an arrangement of items rather than the process of arranging them.

Does that make sense?

[ad-si]

The general distinction makes sense, that's why I left the one "ordering" which seems to be correct unchanged.

But it seems weird that the yaml key should be the verb order instead of the noun. type and path aren't verbs either.
But anyways, feel free to change it as you like. The important fix is just that it said before the key would be "ordering" although it is "order".