diff --git a/common/changes/@itwin/build-tools/docs-residual-typedoc0.26-issues_2024-12-09-20-45.json b/common/changes/@itwin/build-tools/docs-residual-typedoc0.26-issues_2024-12-09-20-45.json new file mode 100644 index 000000000000..35444805da29 --- /dev/null +++ b/common/changes/@itwin/build-tools/docs-residual-typedoc0.26-issues_2024-12-09-20-45.json @@ -0,0 +1,10 @@ +{ + "changes": [ + { + "packageName": "@itwin/build-tools", + "comment": "add temporary fix for typedoc@0.26 issue #2802", + "type": "none" + } + ], + "packageName": "@itwin/build-tools" +} \ No newline at end of file diff --git a/common/config/azure-pipelines/jobs/docs-build.yaml b/common/config/azure-pipelines/jobs/docs-build.yaml index 3079f4ee4fc8..6883d3ba86ff 100644 --- a/common/config/azure-pipelines/jobs/docs-build.yaml +++ b/common/config/azure-pipelines/jobs/docs-build.yaml @@ -45,8 +45,6 @@ parameters: type: boolean default: false - - jobs: - job: DocsBuild displayName: Docs Build @@ -97,7 +95,7 @@ jobs: - task: DownloadPipelineArtifact@2 displayName: Download Core Generated Docs Artifact inputs: - source: 'specific' + source: "specific" project: 2c48216e-e72f-48b4-a4eb-40ff1c04e8e4 pipeline: 7436 # iTwin.js Docs (docs-ci.yaml) artifact: Core Generated Docs @@ -117,7 +115,7 @@ jobs: useCurrentConnectorFrameworkDocsArtifact: ${{ parameters.useCurrentConnectorFrameworkDocsArtifact }} # Currently BeMetalsmith is an internal only tool - - script: npm install @bentley/bemetalsmith@5.3.x + - script: npm install @bentley/bemetalsmith@5.5.x displayName: Install BeMetalsmith workingDirectory: ${{ parameters.workingDir }} diff --git a/tools/build/scripts/docs.js b/tools/build/scripts/docs.js index 368a849c1b82..b4a6d1b9df2f 100644 --- a/tools/build/scripts/docs.js +++ b/tools/build/scripts/docs.js @@ -52,7 +52,9 @@ const readmeOption = (argv.readme === undefined) ? "none" : argv.readme; const options = [ "--hideGenerator", "--logLevel", - "Error" + "Error", + "--cascadedModifierTags", // workaround for https://github.com/TypeStrong/typedoc/issues/2802 + "@experimental" ]; const pluginOptions = [