generate-docs.yml

name: Generate docs

on:
  push:
    branches:
      - trunk
    paths:
      - 'features/src/**/devcontainer-feature.json'
      - 'features/src/**/NOTES.md'
      - '.github/workflows/generate-docs.yml'
  workflow_dispatch:

permissions:
  contents: read

jobs:
  generate-feature-docs:
    name: Generate documentation for features
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      - name: Checkout repository
        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
  
      - name: Generate documentation
        uses: devcontainers/action@1082abd5d2bf3a11abccba70eef98df068277772 # v1.4.3
        with:
          generate-docs: true
          base-path-to-features: ./features/src

      - name: Create a PR for documentation
        uses: peter-evans/create-pull-request@5e914681df9dc83aa4e4905692ca88beb2f9e91f # v7.0.5
        with:
          add-paths: ':(glob)features/src/**/README.md'
          commit-message: 'docs: automated documentation update'
          title: 'docs: automated documentation update'
          body: 'Update documentation for features'
          labels: docs
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}