bug/.github/workflows/documentation.yml at 6dc480f89d29f6044379300a0aff8609c11cfacc · bbc/bug · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
name: Documentation + Storybook

on:
    push:
        branches: ["main"]
        paths:
            - "docs/**"
            - "src/client/src/components/**"
    workflow_dispatch:

permissions:
    contents: read
    pages: write
    id-token: write

concurrency:
    group: "pages"
    cancel-in-progress: true

jobs:
    # Spell check documentation
    codespell:
        runs-on: ubuntu-latest
        steps:
            - uses: actions/checkout@v6
            - name: Spell Check Documentation
              uses: codespell-project/actions-codespell@master
              with:
                  check_filenames: true
                  check_hidden: true
                  path: docs
                  only_warn: 1
                  ignore_words_list: aoto,daa,te

    # Build Storybook
    storybook:
        runs-on: ubuntu-latest
        steps:
            - name: Checkout
              uses: actions/checkout@v6

            - name: Install Dependencies
              run: npm ci

            - name: Build Storybook
              run: |
                  cd src/client
                  npm run build-storybook -- --output-dir storybook-static

            - name: Upload Storybook Artifact
              uses: actions/upload-artifact@v4
              with:
                  name: storybook
                  path: src/client/storybook-static

    # Build Jekyll docs and include Storybook
    pages:
        runs-on: ubuntu-latest
        needs: storybook
        steps:
            - name: Checkout
              uses: actions/checkout@v6

            - name: Download Storybook Artifact
              uses: actions/download-artifact@v4
              with:
                  name: storybook
                  path: storybook-static

            # Merge Storybook into docs folder before Jekyll build
            - name: Add Storybook to docs
              run: |
                  mkdir -p docs/storybook
                  cp -a storybook-static/* docs/storybook/

            - name: Setup Pages
              uses: actions/configure-pages@v5

            - name: Build Jekyll Site
              uses: actions/jekyll-build-pages@v1
              with:
                  source: ./docs
                  destination: ./_site

            - name: Upload Pages Artifact
              uses: actions/upload-pages-artifact@v4
              with:
                  path: ./_site

    # Deploy to GitHub Pages
    deploy:
        needs: pages
        runs-on: ubuntu-latest
        environment:
            name: github-pages
            url: ${{ steps.deployment.outputs.page_url }}
        steps:
            - name: Deploy to GitHub Pages
              id: deployment
              uses: actions/deploy-pages@v4