opendevstack / ods-jenkins-shared-library

Shared Jenkins library which all ODS projects & components use - provisioning, SonarQube code scanning, Nexus publishing, OpenShift template based deployments and repository orchestration
Apache License 2.0
72 stars 57 forks source link

ods-documentation fails as latest is used multiple times #1015

Closed tbugfinder closed 1 year ago

tbugfinder commented 1 year ago

https://github.com/opendevstack/ods-jenkins-shared-library/blob/befbc61c64eab4f309aae0a924ade64d05298fc9/docs/modules/jenkins-shared-library/pages/index.adoc?plain=1#L2

Merge/release of v4.3.0 breaks ods-documentation as LATEST is set in master as well as 4.x branch.

Actually latest is set by antora itself for all pages, so the latest tag could be removed from both page aliases.

@antora/cli: 3.1.4
@antora/site-generator: 3.1.4
[16:40:22.246] FATAL (antora): Duplicate alias: latest@ods-jenkins-shared-library::index.adoc (specified as: latest@ods-jenkins-shared-library:ROOT:index.adoc)
    source: docs/modules/jenkins-shared-library/pages/index.adoc in https://github.com/opendevstack/ods-jenkins-shared-library.git (branch: master | start path: docs)
Add the --stacktrace option to see the cause of the error.
Error: Process completed with exit code 1.

@braisvq1996

BraisVQ commented 1 year ago

This release I tried to not break the documentation with modifications on antora.yml but i still broke the documentation....

Actually latest is set by antora itself for all pages, so the latest tag could be removed from both page aliases.

So we can remove the tag from both branches and avoid more issues in the future

tbugfinder commented 1 year ago

haha, well, never mind :-D