Skip to content

Commit

Permalink
Finalise
Browse files Browse the repository at this point in the history
  • Loading branch information
sblausten committed Jun 16, 2023
1 parent 16acca9 commit 4570c97
Show file tree
Hide file tree
Showing 3 changed files with 13 additions and 6 deletions.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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'
Expand Down
5 changes: 4 additions & 1 deletion action.yml
Original file line number Diff line number Diff line change
@@ -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:
Expand All @@ -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'
12 changes: 8 additions & 4 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -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 [email protected] for more info.

### Required Inputs:
- `api-token`: An API token added as a Bearer token to the Backstage API requests
Expand All @@ -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'
Expand Down

0 comments on commit 4570c97

Please sign in to comment.