action.yml

name: Refresh Release Wiki Pointer
description: Rebuild the authoritative wiki branch from the merged release state and expose whether the parent repository submodule pointer changed.

inputs:
  target:
    description: Wiki target directory or submodule path.
    required: false
    default: .github/wiki
  publish-branch:
    description: Wiki branch to refresh from the merged release state.
    required: false
    default: master
  commit-message:
    description: Commit message used for the wiki branch refresh.
    required: false
    default: Refresh wiki docs after merged release

outputs:
  published:
    description: Whether the wiki publish branch received a new commit.
    value: ${{ steps.refresh.outputs.published }}
  pointer-changed:
    description: Whether the parent repository submodule pointer changed after the wiki publish branch refresh.
    value: ${{ steps.refresh.outputs.pointer-changed }}
  publish-sha:
    description: Final commit SHA at the refreshed wiki publish branch head.
    value: ${{ steps.refresh.outputs.publish-sha }}

runs:
  using: composite
  steps:
    - id: refresh
      shell: bash
      env:
        INPUT_TARGET: ${{ inputs.target }}
        INPUT_PUBLISH_BRANCH: ${{ inputs.publish-branch }}
        INPUT_COMMIT_MESSAGE: ${{ inputs.commit-message }}
      run: ${{ github.action_path }}/run.sh