Improve the documentation

[mkumatag]

/kind cleanup
/area provider/ibmcloud

Improve the current documentation published in https://cluster-api-ibmcloud.sigs.k8s.io

[mkumatag]

cc @kishen-v

[Amulyam24]

Closing this issue as discussion has been initiated on #1545.
/close

[k8s-ci-robot]

@Amulyam24: Closing this issue.

In response to this:

Closing this issue as discussion has been initiated on #1545.
/close

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.