# docs

Reusable workflow — `docs`.

## Inputs

| Input | Type | Required | Default | Description |
|---|---|---|---|---|
| `runtime` | `string` | yes | — | Toolchain to set up: python or node. |
| `build-command` | `string` | yes | — | Shell that builds the static site into output-dir. |
| `output-dir` | `string` | yes | — | Directory to deploy to Cloudflare Pages. |
| `setup-just` | `boolean` | no | `false` | Install `just` (python docs run `just docs`). |

## Secrets

| Secret | Required | Description |
|---|---|---|
| `CLOUDFLARE_API_TOKEN` | yes | Cloudflare API token with Pages:Edit. Pass via `secrets: inherit`. |

## Usage

```yaml
jobs:
  deploy:
    uses: FSHTech/github-actions/.github/workflows/docs.yml@v1
    with:
      runtime: ...
      build-command: ...
      output-dir: ...
    secrets: inherit
```