Skip to content

Commit b8fd360

Browse files
committed
fix: streamline API docs generation to sync both locations
Updated make docs to generate swagger.json to both api-docs/ and web/project-site/public/api/ to match CI workflow behavior. This fixes CI failures where the project site swagger.json was out of sync with code changes (max_new_tokens field for Voxtral).
1 parent f9a58ba commit b8fd360

File tree

2 files changed

+7
-1
lines changed

2 files changed

+7
-1
lines changed

Makefile

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,9 @@ docs: ## Generate API documentation from Go code annotations
5555
@echo "Generating API documentation..."
5656
@command -v swag >/dev/null 2>&1 || { echo "Error: swag not installed. Run: go install github.com/swaggo/swag/cmd/swag@latest"; exit 1; }
5757
swag init -g cmd/server/main.go -o api-docs
58-
@echo "✓ API documentation generated in api-docs/"
58+
@echo "Syncing to project site..."
59+
swag init -g server/main.go -o web/project-site/public/api --outputTypes json --dir cmd,internal
60+
@echo "✓ API documentation generated in api-docs/ and web/project-site/public/api/"
5961

6062
docs-clean: ## Clean generated API documentation
6163
@echo "Cleaning API documentation..."

web/project-site/public/api/swagger.json

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4855,6 +4855,10 @@
48554855
"description": "Output formatting",
48564856
"type": "integer"
48574857
},
4858+
"max_new_tokens": {
4859+
"description": "Voxtral settings",
4860+
"type": "integer"
4861+
},
48584862
"max_speakers": {
48594863
"type": "integer"
48604864
},

0 commit comments

Comments
 (0)