Document initial list of linting problems

[pritishpai]

Changes

List of common linting problems and their resolution/reasoning

Linked issues

Introduces #2122

Functionality

• [x] added relevant user documentation
• [ ] added new CLI command
• [ ] modified existing command: databricks labs ucx ...
• [ ] added a new workflow
• [ ] modified existing workflow: ...
• [ ] added a new table
• [ ] modified existing table: ...