Document command autocompletion functionality (#39)

Author: joaopalet

AUTOCOMPLETION.md

@@ -0,0 +1,65 @@
+# Autocompletion
+
+This guide describes how you can enable command autocompletion for the STACKIT CLI by leveraging the functionality provided the [Cobra](https://github.com/spf13/cobra) framework.
+
+The process may vary depending on the type of shell you are using and your operating system (OS).
+
+You will need to start a new shell for the setup to take effect.
+
+## bash
+
+This process depends on the `bash-completion` package. If you don't have it installed already, you can install it via your OS's package manager.
+
+#### Linux
+
+```shell
+stackit completion bash > /etc/bash_completion.d/stackit
+```
+
+#### macOS
+
+```shell
+stackit completion bash > $(brew --prefix)/etc/bash_completion.d/stackit
+```
+
+## zsh
+
+If shell completion is not already enabled in your environment you will need to enable it by executing the following once:
+
+```shell
+echo "autoload -U compinit; compinit" >> ~/.zshrc
+```
+
+#### Linux
+
+```shell
+stackit completion zsh > "${fpath[1]}/_stackit"
+```
+
+#### macOS
+
+```shell
+stackit completion zsh > $(brew --prefix)/share/zsh/site-functions/_stackit
+```
+
+Additionaly, you might also need to run:
+
+```shell
+source $(brew --prefix)/share/zsh/site-functions/_stackit >> ~/.zshrc
+```
+
+## PowerShell
+
+You can load completions for your current shell session by running:
+
+```shell
+stackit completion powershell | Out-String | Invoke-Expression
+```
+
+To load completions for every new session, add the output of the above command to your PowerShell profile.
+
+## fish
+
+```shell
+stackit completion fish > ~/.config/fish/completions/stackit.fish
+```

README.md

@@ -7,7 +7,7 @@ Your feedback is appreciated!
 
 ## Installation
 
-Please refer to our [installation](./INSTALLATION.md) guide for instructions on how to install and get started using the STACKIT CLI.
+Please refer to our [installation guide](./INSTALLATION.md) for instructions on how to install and get started using the STACKIT CLI.
 
 ## Usage
 
@@ -65,7 +65,7 @@ To authenticate using a service account, run:
 $ stackit auth activate-service-account
 ```
 
-For more details on how to setup authentication using a service account, check our [Authentication guide](./AUTHENTICATION.md)
+For more details on how to setup authentication using a service account, check our [authentication guide](./AUTHENTICATION.md).
 
 ## Configuration
 
@@ -97,13 +97,17 @@ $ stackit config list
 
 You can also edit the configuration file manually.
 
+## Autocompletion
+
+If you wish to setup command autocompletion in your shell for the STACKIT CLI, please refer to our [autocompletion guide](./AUTOCOMPLETION.md).
+
 ## Reporting issues
 
 If you encounter any issues or have suggestions for improvements, please reach out to the Developer Tools team or open a ticket through the [STACKIT Help Center](https://support.stackit.cloud/).
 
 ## Contribute
 
-Your contribution is welcome! For more details on how to contribute, refer to our [Contribution Guide](./CONTRIBUTION.md).
+Your contribution is welcome! For more details on how to contribute, refer to our [contribution guide](./CONTRIBUTION.md).
 
 ## License