Enhance the doc

[mkumatag]

/kind cleanup
/kind doc
/area provider/ibmcloud

What steps did you take and what happened:
[A clear and concise description of what the bug is.]

What did you expect to happen:

Anything else you would like to add:
[Miscellaneous information that will assist in solving the issue.]

Environment:

• Cluster-api version:
• Minikube/KIND version:
• Kubernetes version: (use kubectl version):
• OS (e.g. from /etc/os-release):

[k8s-ci-robot]

@mkumatag: The label(s) kind/doc cannot be applied, because the repository doesn't have them.

In response to this:

/kind cleanup
/kind doc
/area provider/ibmcloud

What steps did you take and what happened:
[A clear and concise description of what the bug is.]

What did you expect to happen:

Anything else you would like to add:
[Miscellaneous information that will assist in solving the issue.]

Environment:

• Cluster-api version:
• Minikube/KIND version:
• Kubernetes version: (use kubectl version):
• OS (e.g. from /etc/os-release):

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.

[Amulyam24]

The CAPIBM doc needs to be enhanced to ensure easy understanding by users. The data is not well organized into sections or subsections, lacks indentation, and can make proper use of quoted blocks to highlight important notes. A good starting point for improvements would be the getting started page.