From 4570c97b402d475141d47ae2b24096536938e1d9 Mon Sep 17 00:00:00 2001 From: sblausten Date: Fri, 16 Jun 2023 12:07:17 +0200 Subject: [PATCH] Finalise --- README.md | 2 +- action.yml | 5 ++++- docs/index.md | 12 ++++++++---- 3 files changed, 13 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 80242b6..4e349fc 100644 --- a/README.md +++ b/README.md @@ -33,7 +33,7 @@ jobs: steps: - uses: actions/checkout@v3 - name: Sync Backstage Techdocs - uses: roadiehq/ + uses: roadiehq/backstage-techdocs-sync with: api-token: ${{ secrets.ROADIE_API_KEY }} catalog-info-path: './catalog-info.yaml' diff --git a/action.yml b/action.yml index 9adb9bc..7fb6579 100644 --- a/action.yml +++ b/action.yml @@ -1,4 +1,4 @@ -name: Sync Backstage TechDocs +name: Backstage TechDocs Sync author: RoadieHQ description: "Builds a fresh rendered version of a repository's Backstage TechDocs using the Backstage API" inputs: @@ -15,6 +15,9 @@ inputs: github-token: description: 'A Github PAT to check if the docs were updated in this branch - if not passed this action will sync the docs every time' required: false +branding: + icon: 'book-open' + color: 'orange' runs: using: 'node16' main: 'dist/index.js' diff --git a/docs/index.md b/docs/index.md index d954772..f569c82 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,8 +1,12 @@ # Sync Backstage TechDocs Action -This Action is for [Roadie Backstage](https://roadie.io/) customers who have access to the Roadie API in their plan. +This Action allows CI triggered building of Backstage TechDocs for a repository so that you don't have to wait for docs to build on demand when viewing a new version. -It updates a repository's Backstage [Techdocs](https://roadie.io/docs/getting-started/technical-documentation/) build in Roadie so that you don't have to wait for the docs to build when visiting the docs after a change has been made. +### Prerequisites + +This Action assumes that you have a publicly available HTTP API exposed from your Backstage backend that uses a Bearer token for Authorization. + +[Roadie Backstage](https://roadie.io/) customers may access this via the Roadie API. Please reach out to support@roadie.io for more info. ### Required Inputs: - `api-token`: An API token added as a Bearer token to the Backstage API requests @@ -28,8 +32,8 @@ jobs: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - - name: Sync Roadie Techdocs - uses: roadiehq/ + - name: Sync Backstage Techdocs + uses: roadiehq/backstage-techdocs-sync with: api-token: ${{ secrets.ROADIE_API_KEY }} catalog-info-path: './catalog-info.yaml'