@epriestley where is the propper place then to help improving documentation?

You should file a new bug report, describing exactly what you did and how we can reproduce the problem.

Then we'll decide if we should fix it by improving the documentation, or adding an additional check, or removing the need to write, or doing nothing because some step in the requirements is too bizarre.

Generally, it's much better if a script can automatically detect problems than if the documentation warns you about them, because many users do not read the documentation or do not read it completely. Adding a lot of rarely-encountered edge cases to the documentation makes these problems worse: users are less likely to read a larger document, and more likely to miss important information if the document contains a lot of irrelevant information.