Add documentation for autofixing key-order rule

[shatakshiiii]

Related: #3624

[ssbarnea]

My view on this is that we do not need to flood the user with extra examples for the auto-fix when the change is obvious and matches our already existing examples in rule documentation.

I looked at the produced documentation page and I seen it becoming long enough to detect many people from reading it.

I personally think that it was enough to mention that this rule can be automatically fixed in a paragraph inside the correct example section.

@ganeshrn WDYT about this?

[ganeshrn]

My view on this is that we do not need to flood the user with extra examples for the auto-fix when the change is obvious and matches our already existing examples in rule documentation.

I looked at the produced documentation page and I seen it becoming long enough to detect many people from reading it.

I personally think that it was enough to mention that this rule can be automatically fixed in a paragraph inside the correct example section.

@ganeshrn WDYT about this?

Yup a visible mention that the rule supports autofix will be good enough.