feat: Removed comments in workflow

go list -m -f '{{.Dir}}' reports an empty Dir and exits 0 for a module that
is not in the cache, so on a cold runner swag was handed an empty --dir and
failed several steps later with 'dir:  does not exist'. Download first, and
fail loudly if the path is still not there.

.gitea/workflows/server-deploy.yml

@@ -130,13 +130,13 @@ jobs:
               run: |
                   go install github.com/swaggo/swag/v2/cmd/swag@v2.0.0-rc5
                   cd server
-                  # swag reads Go source, not the import graph, so it needs the
-                  # shared module's files on disk. They are in the module cache
-                  # now rather than at ../shared, and the cache is read-only,
-                  # which swag does not mind.
+                  go mod download gitea.hostxtra.co.uk/vantage/vantage-shared
                   SHARED_DIR="$(go list -m -f '{{.Dir}}' gitea.hostxtra.co.uk/vantage/vantage-shared)"
-                  swag init --generalInfo cmd/main.go --dir "./,$SHARED_DIR" \
-                    --output internal/api/docs --outputTypes json --v3.1
+                  if [ -z "$SHARED_DIR" ] || [ ! -d "$SHARED_DIR" ]; then
+                      echo "vantage-shared source not in the module cache: '$SHARED_DIR'" >&2
+                      exit 1
+                  fi
+                  swag init --generalInfo cmd/main.go --dir "./,$SHARED_DIR" --output internal/api/docs --outputTypes json --v3.1
                   mv -f internal/api/docs/swagger.json internal/api/docs/openapi.json
                   git diff --exit-code internal/api/docs/openapi.json