fix: Add `vendor` step to `make docs`

This commit is contained in:
Ilya Kuznetsov 2025-01-15 16:21:45 +01:00
parent 1e41e6140d
commit 14b2c86d61
No known key found for this signature in database
GPG Key ID: 91F3DDCF5D21CDDF
2 changed files with 4 additions and 5 deletions

View File

@ -37,7 +37,7 @@ vendor:
schema: schema:
go run ./bundle/internal/schema ./bundle/internal/schema ./bundle/schema/jsonschema.json go run ./bundle/internal/schema ./bundle/internal/schema ./bundle/schema/jsonschema.json
docs: docs: vendor
go run ./bundle/internal/docs ./bundle/internal/schema ./bundle/internal/docs go run ./bundle/internal/docs ./bundle/internal/schema ./bundle/internal/docs
INTEGRATION = gotestsum --format github-actions --rerun-fails --jsonfile output.json --packages "./integration/..." -- -parallel 4 -timeout=2h INTEGRATION = gotestsum --format github-actions --rerun-fails --jsonfile output.json --packages "./integration/..." -- -parallel 4 -timeout=2h

View File

@ -1,10 +1,9 @@
## docs-autogen ## docs-autogen
1. Install [Golang](https://go.dev/doc/install) 1. Install [Golang](https://go.dev/doc/install)
2. Run `go mod download` from the repo root 2. Run `make docs` from the repo
3. Run `make docs` from the repo 3. See generated documents in `./bundle/internal/docs/output` directory
4. See generated documents in `./bundle/internal/docs/output` directory 4. To change descriptions update content in `./bundle/internal/schema/annotations.yml` or `./bundle/internal/schema/annotations_openapi_overrides.yml` and re-run `make docs`
5. To change descriptions update content in `./bundle/internal/schema/annotations.yml` or `./bundle/internal/schema/annotations_openapi_overrides.yml` and re-run `make docs`
For simpler usage run it together with copy command to move resulting files to local `docs` repo. Note that it will overwrite any local changes in affected files. Example: For simpler usage run it together with copy command to move resulting files to local `docs` repo. Note that it will overwrite any local changes in affected files. Example: