added optional group name property and used it for error messages

[mbrowne]

Resolves #72

[hudochenkov]

Thank you for working on this!

As I said before, logic should be located in other place.

Inside this block you can add group name for every property, if grope name is present:

stylelint-order/rules/properties-order/createExpectedOrder.js

Lines 15 to 26 in 3215ac3

	if (_.isString(item)) {
	// In flexible groups, the expectedPosition does not ascend
	// to make that flexibility work;
	// otherwise, it will always ascend
	if (!inFlexibleGroup) {
	expectedPosition += 1;
	}
	order[item] = { separatedGroup, expectedPosition };
	return;
	}

Then pass groupName to:

stylelint-order/rules/properties-order/checkNode.js

Lines 51 to 54 in 3215ac3

	message: sharedInfo.messages.expected(
	checkedOrder.secondNode.name,
	checkedOrder.firstNode.name
	),

Please, add tests and documentation.

[hudochenkov]

Please, use @jeddy3's suggestion:

Expected "${first}" to come before "${second}" in group "${groupName}"

Conditionally add “in group...”.

[mbrowne]

I refactored the code and added tests and documentation. I thought it would be good for the readme to include at least one example of using groupName so I added it to the first config example using a group, but if you think that's distracting at all you can feel free to remove it. In any case I added groupName to the documentation for valid group config options.

[hudochenkov]

Looks good! Thanks!

[mbrowne]

Thanks for merging. Note that I didn't bump the version number—I was leaving it up to you to decide about that. Do you expect to publish a new version of the npm package sometime soon?

[hudochenkov]

I want to include a fix for #74 in the next version. I'll most likely do it during this week.

[hudochenkov]

Released in stylelint-order@2.0.0.

[mbrowne]

Great, thank you :)