--write mode for lint does not have a proper documentation

[sgabenov]

There is only mention for --write mode in --helpoutput. Would be nice to make a section with some examples on how to use this mode. Good to have it here: https://ansible.readthedocs.io/projects/lint/usage/#auto-transofmations or something like this
It is not straight forward what this mode can do. Need to add documentation on what rules it can apply auto-fix and for what rules it will pass rule violation
The behavior is not easy to understand. It is hard to understand how to fix only specific rule-id, what are the rule-id and how to overcome configuration from .ansible-lint config. I have read the help for 10 times and still not sure i have the idea how it is working. Please add some good examples on how to use it!
For instance, for i can only fix yaml line-lenght when i have a configuration file for lint and i want to do transforms recursevely for the whole repo.
Also, from documentation is not very good described what is a "rule-id" that can be used with --write option. As --list-rules gives a bit different rule names compared to the list of rules in the output that shows linter after i use --write option. I think there should be an example for it.