docs(website): added extension related use cases with API references (podman-desktop#11978)

* docs(website): added extension related use cases with API references

Signed-off-by: Shipra Singh <[email protected]>

* docs(website): corrected cross-references

Signed-off-by: Shipra Singh <[email protected]>

---------

Signed-off-by: Shipra Singh <[email protected]>

Author: shipsing

website/docs/extensions/api/index.md

@@ -6,4 +6,17 @@ tags: [podman-desktop, extension, api]
 keywords: [podman desktop, extension, api]
 ---
 
-The API reference is located [here](/api).
+The extension API reference is located [here](/api).
+
+Based on your use cases, you can add these common capabilities to your extension:
+
+- Create a new CLI tool instance and register it with Podman Desktop, see the details [here](https://podman-desktop.io/api/@podman-desktop/namespaces/cli/functions/createCliTool). You can add the `createCliTool()` function with relevant parameters in your `src/extension.ts` file.
+  - Register the state of a CLI tool, see the [resource](/api/type-aliases/CliToolState).
+- Add operations related to a container engine, see the usage of the [containerEngine](https://podman-desktop.io/api/@podman-desktop/namespaces/containerEngine) API.
+- Add a new Kubernetes provider connection, use the [`KubernetesProviderConnection`](/api/interfaces/KubernetesProviderConnection) interface.
+- Enable navigation to a CLI tool page, use the function [`navigateToCliTools()`](https://podman-desktop.io/api/@podman-desktop/namespaces/navigation/functions/navigateToCliTools).
+- Enable navigation to a specific page in the UI, refer to the [navigation APIs](https://podman-desktop.io/api/@podman-desktop/namespaces/navigation) category.
+- Create and show a new webview panel in the UI, use the [`createWebviewPanel()`](https://podman-desktop.io/api/@podman-desktop/namespaces/window/functions/createWebviewPanel) function.
+- Add options for running a command, use the [`RunOptions`](/api/interfaces/RunOptions) interface.
+
+You can also create your own custom extensions and add them to the catalog for others to use.