docs: update lint.md

[JodyWinter]

What/Why/How?

Substantive edit, update and testing.

Reference

Testing

Done.

Screenshots (optional)

Check yourself

• [ ] Code is linted
• [ ] Tested with redoc/reference-docs/workflows
• [ ] All new/updated code is covered with tests

Security

• [ ] Security impact of change has been considered
• [ ] Code follows company security practices and guidelines