Docs feedback: Code quality hard to set up

https://docs.gitlab.com/ee/user/project/merge_requests/code_quality.html#example-configuration

It's fairly confusing on how codequality should be set up for modern (12.x) versions of Gitlab. For example:

• Is the produced filename important anymore? The docs suggest the name was meaningful in older versions, but do not indicate how modern versions determine which file to pull this report from.
• Is the job name significant?
• How do I troubleshoot Gitlab not recognizing a codequality file?