A GitHub action to create documentation for V modules.

Under the hood it's a wrapper around v doc.

This action is supposed to work with with nocturlab/setup-vlang-action and test-room-7/action-update-file actions.

This workflow generates documentation for a module and pushes a new commit if documentation is changed.

name: Docs
on:
  push:
    branches: [master]
  pull_request:
    types: [opened, synchronize]
jobs:
  update-docs:
    name: Update docs
    runs-on: ubuntu-latest
    steps:
      - name: Checkout the repository
        uses: actions/checkout@v1

      - name: Install V
        uses: nocturlab/setup-vlang-action@v1
        with:
          v-version: master

      - name: Generate documentation
        uses: test-room-7/action-create-v-docs@v0
        with:
          docs-dir: docs

      - name: Update documentation
        uses: test-room-7/action-update-file@v1
        with:
          file-path: docs/*
          commit-msg: Update documentation
          github-token: ${{ secrets.GITHUB_TOKEN }}

Once this workflow is executed, the docs directory with documentation will be added (or updated if necessary) to your repository. Optionally, you can set up GitHub Pages for your repository to have documentation available at yourname.github.io/yourmodule.

• docs-dir: a directory where documentation will be placed.

• module-dir: a directory where module source files are placed.

Licensed under the MIT License.