Docs scripts cleanup

[abadger]

SUMMARY

As discussed in this thread: #55986 (comment) the build subcommands for documentation should make the definition files mandatory. Since they're mandatory, the files should be positional arguments instead of option arguments.

ISSUE TYPE

• Bugfix Pull Request
• Docs Pull Request

COMPONENT NAME

ADDITIONAL INFORMATION

@webknjaz @acozine

[abadger]

This PR can be squashed on merge. I just made two commits to separate the two logical changes.

[ansibot]

The test ansible-test sanity --test docs-build [explain] failed with the error:

Command "/usr/bin/python3.6 /root/ansible/test/sanity/code-smell/docs-build.py" returned exit status 1.
>>> Standard Error
Command 'make singlehtmldocs' failed with status code: 2
--> Standard Output
PYTHONPATH=../../lib ../../hacking/build-ansible.py document-config --template-file=../templates/config.rst.j2 --output-dir=rst/reference_appendices/ ../../lib/ansible/config/base.yml
Makefile:90: recipe for target 'config' failed
--> Standard Error
Traceback (most recent call last):
  File "../../hacking/build-ansible.py", line 88, in <module>
    main()
  File "../../hacking/build-ansible.py", line 79, in main
    retval = command.main(args)
  File "/root/ansible/hacking/build_library/build_ansible/command_plugins/dump_config.py", line 63, in main
    with open(args.config_defs) as f:
TypeError: expected str, bytes or os.PathLike object, not list
make: *** [config] Error 1

click here for bot help