chore: drop internal comments from public workflows

Author: ph33nx

.github/workflows/ci.yml

@@ -9,9 +9,6 @@ permissions:
   contents: read
 
 jobs:
-  # Drift, format and vet use the workspace (which includes the maintainer tool in
-  # tools/roxygen) on a current Go. `go vet` also type-checks, so there is no separate
-  # build step; the consumer build is covered by the test job below.
   checks:
     runs-on: ubuntu-latest
     steps:
@@ -38,8 +35,6 @@ jobs:
       - name: Vet
         run: go vet ./...
 
-  # The published module is built and tested from the consumer's perspective
-  # (GOWORK off, no maintainer tooling) across supported Go versions.
   test:
     runs-on: ubuntu-latest
     strategy:

.github/workflows/release.yml

@@ -2,19 +2,16 @@ name: Release
 
 on:
   repository_dispatch:
-    types: [openapi-updated] # fired by the server repo on an OpenAPI change
+    types: [openapi-updated]
   schedule:
-    - cron: '0 6 * * *' # daily fallback, also covers an unwired dispatch
+    - cron: '0 6 * * *'
   workflow_dispatch:
     inputs:
       version_bump:
         description: 'patch | minor | major'
         required: false
         default: 'patch'
 
-# Go has no package registry and no OIDC publish: a release is just a git tag that
-# pkg.go.dev indexes through the module proxy. The only token needed is the default
-# GITHUB_TOKEN for the commit and tag. There are no publish secrets.
 permissions:
   contents: write
 
@@ -24,16 +21,16 @@ jobs:
     steps:
       - uses: actions/checkout@v7
         with:
-          fetch-depth: 0 # need all tags to compute the next version
+          fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
       - uses: actions/setup-go@v6
         with:
           go-version: stable
 
-      - name: Regenerate from live spec
+      - name: Regenerate from spec
         run: go run ./tools/roxygen generate
 
-      - name: Detect drift
+      - name: Detect changes
         id: diff
         run: |
           if git diff --quiet -- specs/openapi.json roxyapi.gen.go roxy.gen.go README.md AGENTS.md docs/llms-full.txt; then
@@ -67,7 +64,6 @@ jobs:
           VER="$MA.$MI.$PA"
           sed -i "s/const Version = \".*\"/const Version = \"$VER\"/" version.go
           echo "version=$VER" >> "$GITHUB_OUTPUT"
-          echo "Next version: v$VER"
 
       - name: Commit, tag, push
         if: steps.diff.outputs.changed == 'true' || github.event_name == 'workflow_dispatch'
@@ -80,9 +76,7 @@ jobs:
           git tag "v$V"
           git push --follow-tags
 
-      - name: Prompt pkg.go.dev to index the new version
-        # The documented way to get a module indexed: ask the proxy for it via the go
-        # tool (handles module-path case encoding; no manual curl bang-encoding).
+      - name: Index new version on pkg.go.dev
         if: steps.diff.outputs.changed == 'true' || github.event_name == 'workflow_dispatch'
         env:
           GOPROXY: proxy.golang.org

tools/roxygen/main.go

@@ -1,4 +1,4 @@
-// Command roxygen is the RoxyAPI Go SDK maintainer tool. The live OpenAPI spec at
+// Command roxygen is the RoxyAPI Go SDK code generator. The OpenAPI spec at
 // roxyapi.com is the single source of truth; everything below regenerates from it.
 //
 //	roxygen generate    Fetch the spec, normalize it for oapi-codegen, generate the