review fixes

Author: danciaclara

docs/self-hosting/methods/download-config.md

@@ -1,11 +1,52 @@
 ---
 title: Download version config
-description: Download docker-compose.yml and variables.env files for a given Plane release as a zip archive.
+description: Download docker-compose.yml and variables.env files for a specific Plane release as a zip archive.
 keywords: plane, self-hosting, setup, docker compose, config download, version config, airgapped, variables.env
 ---
 
 # Download version config
 
+If you're running a custom Docker setup and don't use `prime-cli`, you can download the `docker-compose.yml` and `variables.env` files for any Plane release directly.
+
+## Quick download
+
+**Standard setup**
+
+```bash
+curl "https://prime.plane.so/api/v2/setup/?version=v2.3.4" -o plane.zip
+unzip plane.zip
+```
+
+**Airgapped setup (AMD64)**
+
+```bash
+curl "https://prime.plane.so/api/v2/setup/?version=v2.3.4&airgapped=true" -o plane.zip
+unzip plane.zip
+```
+
+**Airgapped setup (ARM64)**
+
+```bash
+curl "https://prime.plane.so/api/v2/setup/?version=v2.3.4&airgapped=true&platform=arm64" -o plane.zip
+unzip plane.zip
+```
+
+Replace `v2.3.4` with the version you need. See the [releases page](https://plane.so/changelog?category=self-hosteds) for available versions.
+
+## What's in the zip
+
+**Standard download**
+- `docker-compose.yml`
+- `variables.env`
+
+**Airgapped download**
+- `airgapped-docker-compose-{platform}.yml`
+- `variables.env`
+
+---
+
+## API reference
+
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
   <span class="path">/api/v2/setup/</span>
@@ -14,33 +55,31 @@ keywords: plane, self-hosting, setup, docker compose, config download, version c
 <div class="api-two-column">
 <div class="api-left">
 
-Download `docker-compose.yml` and `variables.env` files for a given Plane release as a zip archive.
-
-**Authentication:** None required (public endpoint)
-
 **Base URL:** `https://prime.plane.so`
 
+**Authentication:** Not required (public endpoint)
+
 <div class="params-section">
 
-### Query Parameters
+### Query parameters
 
 <div class="params-list">
 
 <ApiParam name="version" type="string" :required="true">
 
-Release tag name (e.g. `v0.23.0`).
+Release tag (e.g., `v2.3.4`).
 
 </ApiParam>
 
 <ApiParam name="airgapped" type="boolean">
 
-Set to `true` to get airgapped compose files. Defaults to `false`.
+Set to `true` for airgapped compose files. Defaults to `false`.
 
 </ApiParam>
 
 <ApiParam name="platform" type="string">
 
-Target architecture: `amd64` or `arm64`. Defaults to `amd64`. Only relevant when `airgapped` is `true`.
+Target architecture: `amd64` or `arm64`. Defaults to `amd64`. Only applies when `airgapped=true`.
 
 </ApiParam>
 
@@ -51,7 +90,7 @@ Target architecture: `amd64` or `arm64`. Defaults to `amd64`. Only relevant when
 
 ### Response
 
-**Success (200):** Returns a zip file download containing the config files for the requested release.
+**Success (200):** Returns a zip archive containing the config files.
 
 - Content-Type: `application/zip`
 - Content-Disposition: `attachment; filename="plane-{version}.zip"`
@@ -70,40 +109,40 @@ Target architecture: `amd64` or `arm64`. Defaults to `amd64`. Only relevant when
 
 <div class="params-section">
 
-### Error Responses
+### Errors
 
-| Status | Condition                                     | Body                                                    |
-| ------ | --------------------------------------------- | ------------------------------------------------------- |
-| 400    | `version` query param missing                 | `{"error": "version query parameter is required"}`      |
-| 400    | `platform` is not `amd64` or `arm64`          | `{"error": "platform must be amd64 or arm64"}`          |
-| 400    | Server missing GitHub configuration           | `{"error": "missing required settings"}`                |
-| 404    | Release tag not found on GitHub               | `{"error": "release not found"}`                        |
-| 404    | Required asset files missing from the release | `{"error": "assets not found in release: <filenames>"}` |
-| 500    | GitHub API failure                            | `{"error": "Failed to fetch release information"}`      |
+| Status | Cause | Response |
+|--------|-------|----------|
+| 400 | Missing `version` parameter | `{"error": "version query parameter is required"}` |
+| 400 | Invalid `platform` value | `{"error": "platform must be amd64 or arm64"}` |
+| 400 | Server missing GitHub configuration | `{"error": "missing required settings"}` |
+| 404 | Release tag not found | `{"error": "release not found"}` |
+| 404 | Config files missing from release | `{"error": "assets not found in release: <filenames>"}` |
+| 500 | GitHub API failure | `{"error": "Failed to fetch release information"}` |
 
 </div>
 
 </div>
 <div class="api-right">
 
-<CodePanel title="Download version config" :languages="['cURL', 'Python', 'JavaScript']">
+<CodePanel :languages="['cURL', 'Python', 'JavaScript']">
 <template #curl>
 
 ```bash
 # Download standard config files
-curl "https://prime.plane.so/api/v2/setup/?version=v0.23.0" \
+curl "https://prime.plane.so/api/v2/setup/?version=v2.3.4" \
   -o plane.zip
 
 # Download airgapped config (AMD64)
-curl "https://prime.plane.so/api/v2/setup/?version=v0.23.0&airgapped=true" \
+curl "https://prime.plane.so/api/v2/setup/?version=v2.3.4&airgapped=true" \
   -o plane.zip
 
 # Download airgapped config (ARM64)
-curl "https://prime.plane.so/api/v2/setup/?version=v0.23.0&airgapped=true&platform=arm64" \
+curl "https://prime.plane.so/api/v2/setup/?version=v2.3.4&airgapped=true&platform=arm64" \
   -o plane.zip
 
 # Verify zip contents without extracting
-curl "https://prime.plane.so/api/v2/setup/?version=v0.23.0" \
+curl "https://prime.plane.so/api/v2/setup/?version=v2.3.4" \
   -o plane.zip && unzip -l plane.zip
 ```
 
@@ -116,7 +155,7 @@ import requests
 # Download standard config files
 response = requests.get(
     "https://prime.plane.so/api/v2/setup/",
-    params={"version": "v0.23.0"},
+    params={"version": "v2.3.4"},
 )
 
 with open("plane.zip", "wb") as f:
@@ -126,7 +165,7 @@ with open("plane.zip", "wb") as f:
 response = requests.get(
     "https://prime.plane.so/api/v2/setup/",
     params={
-        "version": "v0.23.0",
+        "version": "v2.3.4",
         "airgapped": "true",
         "platform": "arm64",
     },
@@ -141,55 +180,18 @@ with open("plane.zip", "wb") as f:
 
 ```javascript
 // Download standard config files
-const response = await fetch("https://prime.plane.so/api/v2/setup/?version=v0.23.0");
+const response = await fetch("https://prime.plane.so/api/v2/setup/?version=v2.3.4");
 const blob = await response.blob();
 
 // Download airgapped config (ARM64)
 const airgappedResponse = await fetch(
-  "https://prime.plane.so/api/v2/setup/?version=v0.23.0&airgapped=true&platform=arm64"
+  "https://prime.plane.so/api/v2/setup/?version=v2.3.4&airgapped=true&platform=arm64"
 );
 const airgappedBlob = await airgappedResponse.blob();
 ```
 
 </template>
 </CodePanel>
 
-<ResponsePanel status="200">
-
-```
-Content-Type: application/zip
-Content-Disposition: attachment; filename="plane-v0.23.0.zip"
-
-Archive contents (standard):
-  - docker-compose.yml
-  - variables.env
-
-Archive contents (airgapped, amd64):
-  - airgapped-docker-compose-amd64.yml
-  - variables.env
-```
-
-</ResponsePanel>
-
-<ResponsePanel status="400">
-
-```json
-{
-  "error": "version query parameter is required"
-}
-```
-
-</ResponsePanel>
-
-<ResponsePanel status="404">
-
-```json
-{
-  "error": "release not found"
-}
-```
-
-</ResponsePanel>
-
 </div>
 </div>