Improving "ovirt_disk" (mostly documentation)

[barpavel]

1. Improving ovirt_disk documentation comments (minor rephrasing + typos). WIP

[mwperina]

@barpavel Anything else missing? If not, then please move the PR to review ...

[barpavel]

@barpavel Anything else missing? If not, then please move the PR to review ...

Yes, there were few more things I wanted to add, the PR is not finished. I will try to finish it this week.

[barpavel]

Actually one of the reasons this PR started, was that I saw the following strange documentation, see https://docs.ansible.com/ansible/latest/collections/ovirt/ovirt/ovirt_disk_module.html

bootable boolean

True if the disk should be bootable. By default when disk is created it isn’t bootable.
Choices:
no
yes

I mean pay attention to the text that requires True vs. Choices that have other enum values: yes /no.... I wanted to fix that but I'm not sure should I and how...

[barpavel]

Actually one of the reasons this PR started, was that I saw the following strange documentation, see https://docs.ansible.com/ansible/latest/collections/ovirt/ovirt/ovirt_disk_module.html

bootable boolean

True if the disk should be bootable. By default when disk is created it isn’t bootable.
Choices:
no
yes

I mean pay attention to the text that requires True vs. Choices that have other enum values: yes /no.... I wanted to fix that but I'm not sure should I and how...

@mnecas @mwperina What do you think?