Restructure dependency page for better readability (#1360)

Signed-off-by: Prajyot-Parab <[email protected]>
Co-authored-by: Prajyot-Parab <[email protected]>

Author: k8s-infra-cherrypick-robot

docs/book/src/developer/dependencies.md

@@ -1,26 +1,44 @@
 # Modules and tools dependencies
 
-| Package | Module name | Used by | 
-| --- | ----------- | ------- |
+#### CAPI Packages
+| Package | Module name | Used by |
+| ------- | ----------- | ------- |
 | cluster-api | [sigs.k8s.io/cluster-api](https://github.com/kubernetes-sigs/cluster-api) | [go.mod][go.mod1] |
 | cluster-api/test | [sigs.k8s.io/cluster-api/test](https://github.com/kubernetes-sigs/cluster-api/tree/main/test) | [go.mod][go.mod1]  |
 | cluster-api/hack/tools | [sigs.k8s.io/cluster-api/hack/tools](https://github.com/kubernetes-sigs/cluster-api/tree/main/hack/tools) | [hack/tools/go.mod][go.mod2] |
+
+- ##### K8s Packages
+| Package | Module name | Used by |
+| ------- | ----------- | ------- |
+| api | [k8s.io/api](https://k8s.io/api) | [go.mod][go.mod1] |
+| apiextensions-apiserver | [k8s.io/apiextensions-apiserver](https://k8s.io/apiextensions-apiserver) | [go.mod][go.mod1] |
+| apimachinery | [k8s.io/apimachinery](https://k8s.io/apimachinery) | [go.mod][go.mod1] |
+| cli-runtime | [k8s.io/cli-runtime](https://k8s.io/cli-runtime) | [go.mod][go.mod1] |
+| client-go | [k8s.io/client-go](https://k8s.io/client-go) | [go.mod][go.mod1] |
+| utils | [k8s.io/utils](https://k8s.io/utils) | [go.mod][go.mod1] |
 | controller-runtime | [sigs.k8s.io/controller-runtime](https://sigs.k8s.io/controller-runtime) | [go.mod][go.mod1] |
 | controller-runtime/tools/setup-envtest | [sigs.k8s.io/controller-runtime/tools/setup-envtest](https://sigs.k8s.io/controller-runtime/tools/setup-envtest) | [hack/tools/go.mod][go.mod2] |
 | controller-tools | [sigs.k8s.io/controller-tools](https://sigs.k8s.io/controller-tools) | [hack/tools/go.mod][go.mod2] |
+
+- ##### Test Packages
+| Package | Module name | Used by |
+| ------- | ----------- | ------- |
+| onsi/ginkgo/v2 | [github.com/onsi/ginkgo/v2](https://github.com/onsi/ginkgo) | [go.mod][go.mod1] [hack/tools/go.mod][go.mod2] |
+| onsi/gomega | [github.com/onsi/gomega](https://github.com/onsi/gomega) | [go.mod][go.mod1] |
+
+> Note: The K8s and Test packages are subject to updates with each new CAPI package release.
+
+#### IBM Packages
+| Package | Module name | Used by |
+| ------- | ----------- | ------- |
 | IBM-Cloud/power-go-client | [github.com/IBM-Cloud/power-go-client](https://github.com/IBM-Cloud/power-go-client) | [go.mod][go.mod1] |
 | IBM/go-sdk-core/v5 | [github.com/IBM/go-sdk-core/v5](https://github.com/IBM/go-sdk-core) | [go.mod][go.mod1] |
 | IBM/platform-services-go-sdk | [github.com/IBM/platform-services-go-sdk](https://github.com/IBM/platform-services-go-sdk) | [go.mod][go.mod1] |
 | IBM/vpc-go-sdk | [github.com/IBM/vpc-go-sdk](https://github.com/IBM/vpc-go-sdk) | [go.mod][go.mod1] |
-| onsi/ginkgo/v2 | [github.com/onsi/ginkgo/v2](https://github.com/onsi/ginkgo) | [go.mod][go.mod1] [hack/tools/go.mod][go.mod2] |
-| onsi/gomega | [github.com/onsi/gomega](https://github.com/onsi/gomega) | [go.mod][go.mod1] |
-| api | [k8s.io/api](https://k8s.io/api) | [go.mod][go.mod1] |
-| apiextensions-apiserver | [k8s.io/apiextensions-apiserver](https://k8s.io/apiextensions-apiserver) | [go.mod][go.mod1] |
-| apimachinery | [k8s.io/apimachinery](https://k8s.io/apimachinery) | [go.mod][go.mod1] |
-| cli-runtime | [k8s.io/cli-runtime](https://k8s.io/cli-runtime) | [go.mod][go.mod1] |
-| client-go | [k8s.io/client-go](https://k8s.io/client-go) | [go.mod][go.mod1] |
-| utils | [k8s.io/utils](https://k8s.io/utils) | [go.mod][go.mod1] |
 
+</br>
+
+---
 #### Tools used by E2E tests.
 
 | Package | Used by | GitHub |