From a5b25e7768f115ca35744de667596bc5b628c8ff Mon Sep 17 00:00:00 2001 From: Filip Stawicki Date: Tue, 18 Aug 2026 13:23:35 +0200 Subject: [PATCH 1/4] feat: allow callers to force build step We embed some of our source files in the docs. When these files change, we want to build the docs even if there are no changes directly in the folder containing the docs. Otherwise the embeded file contents will be out of sync with the actual contents of the original file. --- .github/workflows/techdocs.yaml | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/.github/workflows/techdocs.yaml b/.github/workflows/techdocs.yaml index 61dc85e..0180178 100644 --- a/.github/workflows/techdocs.yaml +++ b/.github/workflows/techdocs.yaml @@ -26,6 +26,10 @@ on: type: string default: techdocs-publisher@backstage-production-44f7.iam.gserviceaccount.com required: false + force_build: + type: boolean + default: false + required: false secrets: {} concurrency: @@ -81,7 +85,7 @@ jobs: techdocs: needs: ["setup"] - if: ${{ needs.setup.outputs.build == 'true' }} + if: ${{ needs.setup.outputs.build == 'true' || inputs.force_build == 'true' }} permissions: contents: read id-token: write From 9df77ee0ccd161b8e43f3199b68d67ba52aefb7e Mon Sep 17 00:00:00 2001 From: Filip Stawicki Date: Tue, 18 Aug 2026 13:32:48 +0200 Subject: [PATCH 2/4] Use boolean as a boolean rather than string-encoded boolean --- .github/workflows/techdocs.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/techdocs.yaml b/.github/workflows/techdocs.yaml index 0180178..cd339a7 100644 --- a/.github/workflows/techdocs.yaml +++ b/.github/workflows/techdocs.yaml @@ -85,7 +85,7 @@ jobs: techdocs: needs: ["setup"] - if: ${{ needs.setup.outputs.build == 'true' || inputs.force_build == 'true' }} + if: ${{ needs.setup.outputs.build == 'true' || inputs.force_build }} permissions: contents: read id-token: write From 6eec7f15bacc595d66cb2b558a1dec0a78d3b0f6 Mon Sep 17 00:00:00 2001 From: Filip Stawicki Date: Tue, 18 Aug 2026 13:35:37 +0200 Subject: [PATCH 3/4] document new input variable --- docs/index.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/docs/index.md b/docs/index.md index 3682e32..5eb9728 100644 --- a/docs/index.md +++ b/docs/index.md @@ -122,13 +122,14 @@ jobs: -| Name |  Type |  Required | Description | Default Value | -| ----------------------------------- | -------- | --------- | ---------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | -| `docs_dir` | `string` |  `false` | The directory where the documentation files are stored, relative to the root of the repository | `docs/` | -| `docker-compose-service` | `string` |  `false` | The `docker compose` service hosting the [Techdocs Engineering Image] | `techdocs` | -| `techdocs_bucket` | `string` |  `false` | The name of the Techdocs Cloud Storage Bucket | `coop-techdocs-backstage-production-44f7` | -| `workload_identity_provider` | `string` |  `false` | Workload Identity Federation Provider, used for debugging | `projects/1063410054216/locations/global/workloadIdentityPools/techdocs-pool/providers/techdocs-provider` | -| `workload_identity_service_account` | `string` |  `false` | Service Account that can managed the Cloud Storage Bucket, used for debugging | `techdocs-publisher@backstage-production-44f7.iam.gserviceaccount.com` | +| Name |  Type |  Required | Description | Default Value | +| ----------------------------------- | --------- | --------- | ---------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | +| `docs_dir` | `string` |  `false` | The directory where the documentation files are stored, relative to the root of the repository | `docs/` | +| `docker-compose-service` | `string` |  `false` | The `docker compose` service hosting the [Techdocs Engineering Image] | `techdocs` | +| `techdocs_bucket` | `string` |  `false` | The name of the Techdocs Cloud Storage Bucket | `coop-techdocs-backstage-production-44f7` | +| `workload_identity_provider` | `string` |  `false` | Workload Identity Federation Provider, used for debugging | `projects/1063410054216/locations/global/workloadIdentityPools/techdocs-pool/providers/techdocs-provider` | +| `workload_identity_service_account` | `string` |  `false` | Service Account that can managed the Cloud Storage Bucket, used for debugging | `techdocs-publisher@backstage-production-44f7.iam.gserviceaccount.com` | +| `force_build` | `boolean` |  `false` | Build and attempt to publish techdocs even if no changed were detected. | `false` | From 8df1aedb6ea23d667bddc995d0d2d682b3218b4f Mon Sep 17 00:00:00 2001 From: Filip Stawicki Date: Tue, 18 Aug 2026 13:35:57 +0200 Subject: [PATCH 4/4] typo --- docs/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/index.md b/docs/index.md index 5eb9728..42223f4 100644 --- a/docs/index.md +++ b/docs/index.md @@ -129,7 +129,7 @@ jobs: | `techdocs_bucket` | `string` |  `false` | The name of the Techdocs Cloud Storage Bucket | `coop-techdocs-backstage-production-44f7` | | `workload_identity_provider` | `string` |  `false` | Workload Identity Federation Provider, used for debugging | `projects/1063410054216/locations/global/workloadIdentityPools/techdocs-pool/providers/techdocs-provider` | | `workload_identity_service_account` | `string` |  `false` | Service Account that can managed the Cloud Storage Bucket, used for debugging | `techdocs-publisher@backstage-production-44f7.iam.gserviceaccount.com` | -| `force_build` | `boolean` |  `false` | Build and attempt to publish techdocs even if no changed were detected. | `false` | +| `force_build` | `boolean` |  `false` | Build and attempt to publish techdocs even if no changes were detected. | `false` |