mirror of
https://github.com/lensapp/lens.git
synced 2025-05-20 05:10:56 +00:00
686cb122a3
* add step to verify docs on area/documentation PRs * use GH actions to run the verification * add check if label is set to area/documentation * fix broken links in docs with WIP files * add generating API docs before verifying Signed-off-by: Sebastian Malton <sebastian@malton.name>
68 lines
2.0 KiB
YAML
68 lines
2.0 KiB
YAML
name: Publish docs via GitHub Pages
|
|
on:
|
|
push:
|
|
branches:
|
|
- master
|
|
release:
|
|
types:
|
|
- published
|
|
jobs:
|
|
build:
|
|
name: Deploy docs
|
|
runs-on: ubuntu-latest
|
|
strategy:
|
|
matrix:
|
|
node-version: [12.x]
|
|
steps:
|
|
- name: Set up Python 3.7
|
|
uses: actions/setup-python@v2
|
|
with:
|
|
python-version: '3.x'
|
|
|
|
- name: Install dependencies
|
|
run: |
|
|
python -m pip install --upgrade pip
|
|
pip install git+https://${{ secrets.GH_TOKEN }}@github.com/lensapp/mkdocs-material-insiders.git
|
|
pip install mike
|
|
|
|
|
|
- name: Checkout Release from lens
|
|
uses: actions/checkout@v2
|
|
with:
|
|
fetch-depth: 0
|
|
|
|
- name: git config
|
|
run: |
|
|
git config --local user.email "action@github.com"
|
|
git config --local user.name "GitHub Action"
|
|
|
|
- name: Using Node.js ${{ matrix.node-version }}
|
|
uses: actions/setup-node@v1
|
|
with:
|
|
node-version: ${{ matrix.node-version }}
|
|
|
|
- name: Generate Extensions API Reference using typedocs
|
|
run: |
|
|
yarn install
|
|
yarn typedocs-extensions-api
|
|
|
|
- name: Verify that the markdown is valid
|
|
run: |
|
|
yarn run verify-docs
|
|
|
|
- name: mkdocs deploy master
|
|
if: contains(github.ref, 'refs/heads/master')
|
|
run: |
|
|
mike deploy --push master
|
|
|
|
- name: Get the release version
|
|
if: contains(github.ref, 'refs/tags/v') # && !github.event.release.prerelease (generate pre-release docs until Lens 4.0.0 is GA, see #1408)
|
|
id: get_version
|
|
run: echo ::set-output name=VERSION::${GITHUB_REF/refs\/tags\//}
|
|
|
|
- name: mkdocs deploy new release
|
|
if: contains(github.ref, 'refs/tags/v') # && !github.event.release.prerelease (generate pre-release docs until Lens 4.0.0 is GA, see #1408)
|
|
run: |
|
|
mike deploy --push --update-aliases ${{ steps.get_version.outputs.VERSION }} latest
|
|
mike set-default --push ${{ steps.get_version.outputs.VERSION }}
|