ITADN

Git tag introspection for versioned docs fails

#190Opengoergen95 创建于 2026-05-26
Difficulty: [2] IntermediateEffort: [2] MediumPriority: [3] HighType: ☹︎ Bug
G
goergen95commented
## Prework - [x] Read and agree to the [code of conduct](https://www.contributor-covenant.org/version/2/1/code_of_conduct/) and [contributing guidelines](https://github.com/posit-dev/great-docs/blob/main/.github/CONTRIBUTING.md). - [x] If there is [already a relevant issue](https://github.com/posit-dev/great-docs/issues), whether open or closed, comment on the existing thread instead of posting a new issue. ## Description Thanks for taking care of my other issue. The versioned docs now build successfully, however, only the latest API reference is build. I am trying to use [Strategy B](https://posit-dev.github.io/great-docs/user-guide/multi-version-docs.html#strategy-b-git-tag-introspection) from the docs, where the API reference should automatically be fetched from the provided git tag. Trying strategy C also fails since ```bash great-docs api-snapshot --all-tags ``` actually builds separate snapshots for the tagged versions but with identical content - which is the checked out one. Following the recipe and checkout the repository at a specific tag to then build via, e.g. ```bash great-docs api-snapshot v0.1.0 ``` builds the respective snapshot correctly. However, since I'd prefer the automatic introspection during CI runs this is not a real solution. ## Reproducible example Still not able to reproduce but here's the link to my [project](https://github.com/goergen95/seapig). ## Expected result For tagged versions, I expected great-docs to render the API at that specific state. ## Development environment - Operating System: Linux (locally and on GitHub Actions) - Great Docs Version: dev ## Additional context Find a rendered version of my project's website [here](https://github.com/goergen95/seapig/actions/runs/26242922794?pr=156). ```bash ❯ great-docs versions TAG LABEL STATUS API SOURCE ──────────── ──────────────────── ──────────────── ──────────────────────── dev 0.3.0.dev0 prerelease live introspection 0.2.0 0.2.0 latest ✓ git tag: v0.2.0 0.1.0 0.1.0 — git tag: v0.1.0 ```
0 条评论