From 2ac147bab971e8c13446991f2097f17ff764d0e1 Mon Sep 17 00:00:00 2001
From: phm07 <22707808+phm07@users.noreply.github.com>
Date: Fri, 4 Apr 2025 17:01:31 +0200
Subject: [PATCH 01/15] docs: add better documentation

---
 docs/tutorials/setup-hcloud-cli.md | 158 +++++++++++++++++++++++++++++
 1 file changed, 158 insertions(+)
 create mode 100644 docs/tutorials/setup-hcloud-cli.md

diff --git a/docs/tutorials/setup-hcloud-cli.md b/docs/tutorials/setup-hcloud-cli.md
new file mode 100644
index 000000000..e8b735057
--- /dev/null
+++ b/docs/tutorials/setup-hcloud-cli.md
@@ -0,0 +1,158 @@
+# Setup the hcloud CLI
+
+This tutorial will guide you through the process of setting up the hcloud CLI on your local machine.
+
+## Prerequisites
+
+Before you begin, ensure you have the following:
+
+- A [Hetzner Cloud account](https://console.hetzner.cloud).
+
+## 1. Install the hcloud CLI
+
+### 1.1 Manual installation
+
+You can download pre-built binaries from our [GitHub releases](https://github.com/hetznercloud/cli/releases). 
+Install them by extracting the archive and moving the binary to a directory in your `PATH`.
+
+### 1.2 Installation using Go
+
+If you have Go installed, you can also install hcloud CLI from source using the following command:
+
+```bash
+go install github.com/hetznercloud/cli@latest
+```
+
+> **Note**
+>
+> Binaries built with Go will not have the correct version embedded.
+
+> **Note**
+> 
+> Both of the above installation methods do not provide automatic updates. Please make sure to keep your installation up to date manually.
+
+### 1.3 Installation using Homebrew
+
+On Linux and macOS you can also install the hcloud CLI using Homebrew:
+
+```bash
+brew install hcloud
+```
+
+### 1.4 Installation using scoop
+
+On Windows, you can install `hcloud` using scoop:
+
+```bash
+scoop install hcloud
+```
+
+---
+
+> **Warning**
+>
+> Debian-based distributions (using apt) provide outdated versions of the hcloud CLI.
+> Please consider one of the other installation methods.
+
+## 2. (Optional) Setup auto-completion
+
+hcloud CLI offers auto-completion for bash, zsh, fish and PowerShell. It is recommended to enable it for a better user experience.
+
+### 2.1 Bash
+
+To load completions into the current shell execute:
+
+    source <(hcloud completion bash)
+
+In order to make the completions permanent, append the line above to
+your .bashrc.
+
+### 2.2 Zsh
+
+If shell completions are not already enabled for your environment need
+to enable them. Add the following line to your ~/.zshrc file:
+
+    autoload -Uz compinit; compinit
+
+To load completions for each session execute the following commands:
+
+    mkdir -p ~/.config/hcloud/completion/zsh
+    hcloud completion zsh > ~/.config/hcloud/completion/zsh/_hcloud
+
+Finally add the following line to your ~/.zshrc file, *before* you
+call the compinit function:
+
+    fpath+=(~/.config/hcloud/completion/zsh)
+
+In the end your ~/.zshrc file should contain the following two lines
+in the order given here.
+
+    fpath+=(~/.config/hcloud/completion/zsh)
+    #  ... anything else that needs to be done before compinit
+    autoload -Uz compinit; compinit
+    # ...
+
+You will need to start a new shell for this setup to take effect.
+
+### 2.3 Fish
+
+To load completions into the current shell execute:
+
+    hcloud completion fish | source
+
+In order to make the completions permanent execute once:
+
+    hcloud completion fish > ~/.config/fish/completions/hcloud.fish
+
+### 2.4 PowerShell
+
+To load completions into the current shell execute:
+
+    PS> hcloud completion powershell | Out-String | Invoke-Expression
+
+To load completions for every new session, run
+and source this file from your PowerShell profile.
+
+    PS> hcloud completion powershell > hcloud.ps1
+
+## 3. Create a context
+
+The hcloud CLI uses contexts to manage multiple Hetzner Cloud tokens and set configuration preferences.
+
+First, you need to create an API token.
+Follow the instructions in the [Hetzner Cloud documentation](https://docs.hetzner.com/cloud/api/getting-started/generating-api-token) to create your project API token.
+
+Once you have your token, you can create a context using the following command:
+
+```bash
+hcloud context create <context-name>
+```
+
+Ideally, keep the context name similar to the project name so you can easily identify it later.
+
+When prompted, enter the API token you created earlier. Your context should now be created and activated.
+
+## 4. Verify everything works
+
+To verify that the hcloud CLI is working correctly, you can run the following command:
+
+```bash
+hcloud datacenter list
+```
+
+You should see something like this:
+
+```plaintext
+ID   NAME        DESCRIPTION                   LOCATION
+2    nbg1-dc3    Nuremberg 1 virtual DC 3      nbg1    
+3    hel1-dc2    Helsinki 1 virtual DC 2       hel1    
+4    fsn1-dc14   Falkenstein 1 virtual DC 14   fsn1    
+5    ash-dc1     Ashburn virtual DC 1          ash     
+6    hil-dc1     Hillsboro virtual DC 1        hil     
+7    sin-dc1     Singapore virtual DC 1        sin     
+```
+
+If you see this output, congratulations! You have successfully set up the hcloud CLI on your local machine.
+
+If there are any problems, make sure you followed all steps of this tutorial correctly. If there still are problems,
+you can reach out to our [Support](https://console.hetzner.cloud/support) to get help.

From ab917ba5af2bc41c08657f4c6c83126d993dae94 Mon Sep 17 00:00:00 2001
From: phm07 <22707808+phm07@users.noreply.github.com>
Date: Thu, 17 Apr 2025 11:41:35 +0200
Subject: [PATCH 02/15] add readme

---
 docs/README.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
 create mode 100644 docs/README.md

diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 000000000..066f40e64
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,14 @@
+# Documentation
+
+Welcome to the documentation for the **Hetzner Cloud CLI**.
+
+This documentation is written and organized following the [Diátaxis](https://diataxis.fr/) guidelines. Below you can find a high-level overview of where to look for certain things:
+
+- [Tutorials](tutorials)
+- [Guides](guides)
+- [Reference](reference)
+
+## Getting help
+
+- 🐛 Report bugs using [our issue tracker](https://github.com/hetznercloud/cli/issues/new?issuable_template=bug-report).
+- 🙋 If you need help, reach us using the [Support Center](https://console.hetzner.cloud/support).

From 9de6f1a77519e45f18a140d027870fb2c930c988 Mon Sep 17 00:00:00 2001
From: phm07 <22707808+phm07@users.noreply.github.com>
Date: Thu, 17 Apr 2025 12:38:06 +0200
Subject: [PATCH 03/15] tutorials readme

---
 docs/tutorials/README.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 docs/tutorials/README.md

diff --git a/docs/tutorials/README.md b/docs/tutorials/README.md
new file mode 100644
index 000000000..113c440d4
--- /dev/null
+++ b/docs/tutorials/README.md
@@ -0,0 +1,5 @@
+# Tutorials
+
+This folder contains tutorials for the Hetzner Cloud CLI.
+
+- [Setup the hcloud CLI](setup-hcloud-cli.md)

From e35015e0c3c17e2275441b3826cf9a12d2e5d4f0 Mon Sep 17 00:00:00 2001
From: phm07 <22707808+phm07@users.noreply.github.com>
Date: Thu, 24 Apr 2025 10:17:48 +0200
Subject: [PATCH 04/15] add creating a server tutorial

---
 docs/tutorials/create-a-server.md | 108 ++++++++++++++++++++++++++++++
 1 file changed, 108 insertions(+)
 create mode 100644 docs/tutorials/create-a-server.md

diff --git a/docs/tutorials/create-a-server.md b/docs/tutorials/create-a-server.md
new file mode 100644
index 000000000..ef4cfa917
--- /dev/null
+++ b/docs/tutorials/create-a-server.md
@@ -0,0 +1,108 @@
+# Creating a server
+
+This tutorial covers the process of creating a server using the Hetzner Cloud CLI. It includes creating an SSH Key, 
+uploading it, creating a Server and then connecting to it via SSH.
+
+## Prerequisites
+
+- A functioning installation of the [hcloud CLI](setup-hcloud-cli.md), with a valid active context.
+
+## 1. Create an SSH Key
+
+### 1.1 Generate an SSH Key
+
+While an SSH key is not strictly required to create a server, it is highly recommended for secure access.
+If you don't have an SSH key yet, you can generate one using the following command:
+
+```bash
+ssh-keygen -t ed25519 -f ~/.ssh/hcloud
+```
+
+Your private key will now be located at `~/.ssh/hcloud`. **Do not share your private key with anyone!**
+
+### 1.2 Upload the SSH Key
+
+You can upload your SSH key to Hetzner Cloud using the following command:
+
+```bash
+hcloud ssh-key create --name my-ssh-key --public-key-from-file ~/.ssh/hcloud.pub
+```
+
+**Pro Tip**: You can set this SSH key as the default SSH key for your context using the following command:
+
+```bash
+hcloud config set default-ssh-keys my-ssh-key
+```
+
+## 2. Create a Server
+
+### 2.1 Pick a Server Type
+
+Before creating a server, you need to choose a server type. You can list all available server types using the following command:
+
+```bash
+hcloud server-type list
+```
+
+For this example we will use the `cpx11` server type.
+You can view the details of this server type using the following command:
+
+```bash
+hcloud server-type describe cpx11
+```
+
+### 2.2 Pick an Image
+
+You need to choose an image for your server. You can list all available images using the following command:
+
+```bash
+hcloud image list
+```
+
+There are many images available, including various Linux distributions and pre-configured app images.
+For this example we will use the `ubuntu-24.04` image.
+
+### 2.3 Pick a Location (Optional)
+
+You can choose a location for your server. You can list all available locations using the following command:
+
+```bash
+hcloud location list
+```
+
+If you don't specify a location, one will be chosen for you. This is what we will do in this example.
+
+### 2.4 Create the Server
+
+Now you can create the server using the following command:
+
+```bash
+hcloud server create --name my-server --type cpx11 --image ubuntu-24.04 --ssh-key my-ssh-key
+```
+
+If you set the SSH key as the default SSH key for your context, you can omit the `--ssh-key` flag.
+After the server was created, you will see information about the server, including its IP address.
+
+## 3. Connect to the Server
+
+You can connect to the server using SSH. The CLI contains a built-in utility to do this:
+
+```bash
+hcloud server ssh my-server -i ~/.ssh/hcloud
+```
+
+This command will open an SSH connection to the server using the private key you generated earlier.
+
+## 4. Clean Up
+
+After you are done with the server, you can delete it using the following command:
+
+```bash
+hcloud server delete my-server
+```
+
+You can also delete the SSH key using the following command:
+
+```bash
+hcloud ssh-key delete my-ssh-key
+```

From b6202817fbc873a1a6949cbb459247ce88f2b34d Mon Sep 17 00:00:00 2001
From: phm07 <22707808+phm07@users.noreply.github.com>
Date: Thu, 24 Apr 2025 16:45:14 +0200
Subject: [PATCH 05/15] add output option guide

---
 docs/guides/using-output-options.md | 164 ++++++++++++++++++++++++++++
 1 file changed, 164 insertions(+)
 create mode 100644 docs/guides/using-output-options.md

diff --git a/docs/guides/using-output-options.md b/docs/guides/using-output-options.md
new file mode 100644
index 000000000..d7b1dca9e
--- /dev/null
+++ b/docs/guides/using-output-options.md
@@ -0,0 +1,164 @@
+# Using output options
+
+The CLI allows you to customize the output format of some commands using the `--output` flag. 
+This guide shows you how to use this feature and use it in combination with other tools.
+
+## JSON
+
+`describe`, `list` and `create` commands support JSON output format. To use it, simply add the `--output json` flag to your command.
+
+For example, to get the details of a location in JSON format, you can use the following command:
+
+```bash
+$ hcloud location describe fsn1 --output json
+{
+  "id": 1,
+  "name": "fsn1",
+  "description": "Falkenstein DC Park 1",
+  "country": "DE",
+  "city": "Falkenstein",
+  "latitude": 50.47612,
+  "longitude": 12.370071,
+  "network_zone": "eu-central"
+}
+```
+
+You can combine this with other tools to process the output. For example, you can use `jq` to filter the output:
+
+```bash
+$ hcloud location describe fsn1 --output json | jq '.name'
+"fsn1"
+```
+
+```bash
+$ hcloud location describe fsn1 --output json | jq '{id, name}'
+{
+  "id": 1,
+  "name": "fsn1"
+}
+```
+
+`list` commands return a list of objects in JSON format. For example, to get a list of all locations in JSON format, you can use the following command:
+
+```bash
+$ hcloud location list --output json
+[
+  {
+    "id": 1,
+    "name": "fsn1",
+    "description": "Falkenstein DC Park 1",
+    "country": "DE",
+    "city": "Falkenstein",
+    "latitude": 50.47612,
+    "longitude": 12.370071,
+    "network_zone": "eu-central"
+  },
+  {
+    "id": 2,
+    "name": "nbg1",
+    "description": "Nuremberg DC Park 1",
+    "country": "DE",
+    "city": "Nuremberg",
+    "latitude": 49.452102,
+    "longitude": 11.076665,
+    "network_zone": "eu-central"
+  },
+  ...
+]
+```
+
+Once again, you can use `jq` to filter the output. Following example shows how to get the names of all locations of which the network zone is `eu-central`:
+
+```bash
+$ hcloud location list --output json | jq '[.[] | select(.network_zone == "eu-central") | .name]'    
+[
+  "fsn1",
+  "nbg1",
+  "hel1"
+]
+```
+
+## YAML
+
+`describe`, `list` and `create` commands support YAML output format as well.
+
+```bash
+$ hcloud location describe fsn1 --output yaml
+id: 1
+name: fsn1
+description: Falkenstein DC Park 1
+country: DE
+city: Falkenstein
+latitude: 50.47612
+longitude: 12.370071
+network_zone: eu-central
+```
+
+For YAML, you can use `yq` instead of `jq`.
+
+
+```bash
+$ hcloud location list --output yaml | yq '.[] | [{"id": .id, "name": .name}]'
+- id: 1
+  name: fsn1
+- id: 2
+  name: nbg1
+- id: 3
+  name: hel1
+- id: 4
+  name: ash
+- id: 5
+  name: hil
+- id: 6
+  name: sin
+```
+
+## Go Template Format
+
+`describe` commands support the Go string template format as well. You can read up on the syntax in the 
+[Go documentation](https://pkg.go.dev/text/template/). The template format will be applied to structs from hcloud-go. 
+You can find the structs in the [hcloud-go source code](https://github.com/hetznercloud/hcloud-go/tree/main/hcloud).
+
+For example, you could obtain the number of cores of a server using the following command:
+
+```bash
+$ hcloud server describe my-server --output format={{.ServerType.Cores}}
+2
+```
+
+## Table options
+
+`list` commands support table options as well. These options allow you to customize the output format of the output table,
+if not using JSON or YAML.
+
+### noheader
+
+This option removes the header from the output table.
+
+```bash
+$ hcloud location list --output noheader 
+1   fsn1   Falkenstein DC Park 1   eu-central     DE   Falkenstein  
+2   nbg1   Nuremberg DC Park 1     eu-central     DE   Nuremberg    
+3   hel1   Helsinki DC Park 1      eu-central     FI   Helsinki     
+4   ash    Ashburn, VA             us-east        US   Ashburn, VA  
+5   hil    Hillsboro, OR           us-west        US   Hillsboro, OR
+6   sin    Singapore               ap-southeast   SG   Singapore   
+```
+
+### columns
+
+This option allows you to filter by columns.
+
+```bash
+$ hcloud location list --output columns=id,name,network_zone 
+ID   NAME   NETWORK ZONE
+1    fsn1   eu-central  
+2    nbg1   eu-central  
+3    hel1   eu-central  
+4    ash    us-east     
+5    hil    us-west     
+6    sin    ap-southeast
+```
+
+Using the ``--help`` flag will show you a list of all available columns for this command. Note that these might include
+more than the default columns.

From 0f7bc078335ea5b1b56228442b7d73956d863ae2 Mon Sep 17 00:00:00 2001
From: phm07 <22707808+phm07@users.noreply.github.com>
Date: Thu, 24 Apr 2025 16:48:05 +0200
Subject: [PATCH 06/15] add guide readme

---
 docs/guides/README.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 docs/guides/README.md

diff --git a/docs/guides/README.md b/docs/guides/README.md
new file mode 100644
index 000000000..3d2bc6f93
--- /dev/null
+++ b/docs/guides/README.md
@@ -0,0 +1,5 @@
+# Guides
+
+This folder contains guides on how to accomplish specific tasks with the Hetzner Cloud CLI.
+
+- [Using output options](using-output-options.md)

From 3bd7401404dfdc4c88dbcbb3aad6415ac93afb67 Mon Sep 17 00:00:00 2001
From: phm07 <22707808+phm07@users.noreply.github.com>
Date: Thu, 24 Apr 2025 16:48:31 +0200
Subject: [PATCH 07/15] update tutorials readme

---
 docs/tutorials/README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/tutorials/README.md b/docs/tutorials/README.md
index 113c440d4..b1bc701ff 100644
--- a/docs/tutorials/README.md
+++ b/docs/tutorials/README.md
@@ -3,3 +3,4 @@
 This folder contains tutorials for the Hetzner Cloud CLI.
 
 - [Setup the hcloud CLI](setup-hcloud-cli.md)
+- [Creating a server](create-a-server.md)

From 99c59645cbe6294147a2791126a453222127b46d Mon Sep 17 00:00:00 2001
From: phm07 <22707808+phm07@users.noreply.github.com>
Date: Thu, 24 Apr 2025 17:27:46 +0200
Subject: [PATCH 08/15] Update docs/README.md

Co-authored-by: Jonas L. <jooola@users.noreply.github.com>
---
 docs/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/README.md b/docs/README.md
index 066f40e64..26087836e 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -10,5 +10,5 @@ This documentation is written and organized following the [Diátaxis](https://di
 
 ## Getting help
 
-- 🐛 Report bugs using [our issue tracker](https://github.com/hetznercloud/cli/issues/new?issuable_template=bug-report).
+- 🐛 Report bugs using [our issue tracker](https://github.com/hetznercloud/cli/issues/new?template=bug.yaml).
 - 🙋 If you need help, reach us using the [Support Center](https://console.hetzner.cloud/support).

From b3c445e2411fd66d0d58658e56462765231b6db8 Mon Sep 17 00:00:00 2001
From: phm07 <22707808+phm07@users.noreply.github.com>
Date: Thu, 24 Apr 2025 17:28:04 +0200
Subject: [PATCH 09/15] Update docs/guides/using-output-options.md

Co-authored-by: Jonas L. <jooola@users.noreply.github.com>
---
 docs/guides/using-output-options.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guides/using-output-options.md b/docs/guides/using-output-options.md
index d7b1dca9e..a363d9903 100644
--- a/docs/guides/using-output-options.md
+++ b/docs/guides/using-output-options.md
@@ -122,7 +122,7 @@ You can find the structs in the [hcloud-go source code](https://github.com/hetzn
 For example, you could obtain the number of cores of a server using the following command:
 
 ```bash
-$ hcloud server describe my-server --output format={{.ServerType.Cores}}
+$ hcloud server describe my-server --output format='{{.ServerType.Cores}}'
 2
 ```
 

From 5fd13d57309c5f5fa88e32899b2d0ea7519a42d1 Mon Sep 17 00:00:00 2001
From: phm07 <22707808+phm07@users.noreply.github.com>
Date: Thu, 24 Apr 2025 17:44:28 +0200
Subject: [PATCH 10/15] using output options: add note about combining options
 at the bottom

---
 docs/guides/using-output-options.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/guides/using-output-options.md b/docs/guides/using-output-options.md
index a363d9903..34f5ab944 100644
--- a/docs/guides/using-output-options.md
+++ b/docs/guides/using-output-options.md
@@ -162,3 +162,6 @@ ID   NAME   NETWORK ZONE
 
 Using the ``--help`` flag will show you a list of all available columns for this command. Note that these might include
 more than the default columns.
+
+> [!NOTE]
+> You can also combine both options to use them at once: ``--output noheader --output columns=id,name,network_zone`` 

From 483b6a14a39a61781a200dcd74b643fd31b54f81 Mon Sep 17 00:00:00 2001
From: phm07 <22707808+phm07@users.noreply.github.com>
Date: Thu, 24 Apr 2025 17:55:37 +0200
Subject: [PATCH 11/15] replace tips & warnings with proper github syntax

---
 docs/tutorials/create-a-server.md  | 10 +++++-----
 docs/tutorials/setup-hcloud-cli.md |  9 +++------
 2 files changed, 8 insertions(+), 11 deletions(-)

diff --git a/docs/tutorials/create-a-server.md b/docs/tutorials/create-a-server.md
index ef4cfa917..8c15b3801 100644
--- a/docs/tutorials/create-a-server.md
+++ b/docs/tutorials/create-a-server.md
@@ -28,11 +28,11 @@ You can upload your SSH key to Hetzner Cloud using the following command:
 hcloud ssh-key create --name my-ssh-key --public-key-from-file ~/.ssh/hcloud.pub
 ```
 
-**Pro Tip**: You can set this SSH key as the default SSH key for your context using the following command:
-
-```bash
-hcloud config set default-ssh-keys my-ssh-key
-```
+> [!TIP]
+> You can set this SSH key as the default SSH key for your context using the following command:
+> ```bash
+> hcloud config set default-ssh-keys my-ssh-key
+> ```
 
 ## 2. Create a Server
 
diff --git a/docs/tutorials/setup-hcloud-cli.md b/docs/tutorials/setup-hcloud-cli.md
index e8b735057..ef9f1926e 100644
--- a/docs/tutorials/setup-hcloud-cli.md
+++ b/docs/tutorials/setup-hcloud-cli.md
@@ -23,12 +23,10 @@ If you have Go installed, you can also install hcloud CLI from source using the
 go install github.com/hetznercloud/cli@latest
 ```
 
-> **Note**
->
+> [!NOTE]
 > Binaries built with Go will not have the correct version embedded.
 
-> **Note**
-> 
+> [!NOTE]
 > Both of the above installation methods do not provide automatic updates. Please make sure to keep your installation up to date manually.
 
 ### 1.3 Installation using Homebrew
@@ -49,8 +47,7 @@ scoop install hcloud
 
 ---
 
-> **Warning**
->
+> [!WARNING]
 > Debian-based distributions (using apt) provide outdated versions of the hcloud CLI.
 > Please consider one of the other installation methods.
 

From 33835d56452ea8b7b4e44431dc8b047f79b5ba8c Mon Sep 17 00:00:00 2001
From: phm07 <22707808+phm07@users.noreply.github.com>
Date: Fri, 25 Apr 2025 10:46:25 +0200
Subject: [PATCH 12/15] add manual installation instructions

---
 docs/tutorials/setup-hcloud-cli.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/tutorials/setup-hcloud-cli.md b/docs/tutorials/setup-hcloud-cli.md
index ef9f1926e..5f4e8a359 100644
--- a/docs/tutorials/setup-hcloud-cli.md
+++ b/docs/tutorials/setup-hcloud-cli.md
@@ -15,6 +15,14 @@ Before you begin, ensure you have the following:
 You can download pre-built binaries from our [GitHub releases](https://github.com/hetznercloud/cli/releases). 
 Install them by extracting the archive and moving the binary to a directory in your `PATH`.
 
+On a 64-bit Linux system, it could look something like this:
+
+```bash
+curl -LO https://github.com/hetznercloud/cli/releases/download/v1.50.0/hcloud-darwin-amd64.tar.gz
+sudo tar -C /usr/local/bin -xzf hcloud-darwin-amd64.tar.gz
+rm hcloud-darwin-amd64.tar.gz
+```
+
 ### 1.2 Installation using Go
 
 If you have Go installed, you can also install hcloud CLI from source using the following command:

From 12adfaa8671dee949448d9e5da26f99c9243e771 Mon Sep 17 00:00:00 2001
From: phm07 <22707808+phm07@users.noreply.github.com>
Date: Fri, 25 Apr 2025 13:02:16 +0200
Subject: [PATCH 13/15] better wording

---
 docs/guides/using-output-options.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/guides/using-output-options.md b/docs/guides/using-output-options.md
index 34f5ab944..6127dff58 100644
--- a/docs/guides/using-output-options.md
+++ b/docs/guides/using-output-options.md
@@ -116,8 +116,8 @@ $ hcloud location list --output yaml | yq '.[] | [{"id": .id, "name": .name}]'
 ## Go Template Format
 
 `describe` commands support the Go string template format as well. You can read up on the syntax in the 
-[Go documentation](https://pkg.go.dev/text/template/). The template format will be applied to structs from hcloud-go. 
-You can find the structs in the [hcloud-go source code](https://github.com/hetznercloud/hcloud-go/tree/main/hcloud).
+[Go documentation](https://pkg.go.dev/text/template/). The data structures passed to the template are defined
+by our API and can be found in [hcloud-go](https://pkg.go.dev/github.com/hetznercloud/hcloud-go/v2/hcloud/schema).
 
 For example, you could obtain the number of cores of a server using the following command:
 

From ede4ac2a4c34f5060346b0bcaeab1826739b2b93 Mon Sep 17 00:00:00 2001
From: phm07 <22707808+phm07@users.noreply.github.com>
Date: Thu, 8 May 2025 11:53:22 +0200
Subject: [PATCH 14/15] directly link to main reference file

---
 docs/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/README.md b/docs/README.md
index 26087836e..3d7e829d1 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -6,7 +6,7 @@ This documentation is written and organized following the [Diátaxis](https://di
 
 - [Tutorials](tutorials)
 - [Guides](guides)
-- [Reference](reference)
+- [Reference](reference/hcloud.md)
 
 ## Getting help
 

From 9f8916ea55ee2174a3b2216ed45c9b97834558a6 Mon Sep 17 00:00:00 2001
From: phm07 <22707808+phm07@users.noreply.github.com>
Date: Fri, 9 May 2025 14:49:18 +0200
Subject: [PATCH 15/15] move noheader & columns flag combination note

---
 docs/guides/using-output-options.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/guides/using-output-options.md b/docs/guides/using-output-options.md
index 6127dff58..a69f7c675 100644
--- a/docs/guides/using-output-options.md
+++ b/docs/guides/using-output-options.md
@@ -131,6 +131,9 @@ $ hcloud server describe my-server --output format='{{.ServerType.Cores}}'
 `list` commands support table options as well. These options allow you to customize the output format of the output table,
 if not using JSON or YAML.
 
+> [!NOTE]
+> You can also combine both of the below options to use them at once: ``--output noheader --output columns=id,name,network_zone``
+
 ### noheader
 
 This option removes the header from the output table.
@@ -162,6 +165,3 @@ ID   NAME   NETWORK ZONE
 
 Using the ``--help`` flag will show you a list of all available columns for this command. Note that these might include
 more than the default columns.
-
-> [!NOTE]
-> You can also combine both options to use them at once: ``--output noheader --output columns=id,name,network_zone``