Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
book-open

GitHub Action

Action to update GitHub Action documentation

v1.1.0

Action to update GitHub Action documentation

book-open

Action to update GitHub Action documentation

Update docuemntation in the README file for a GitHub Action based on the action.yml

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Action to update GitHub Action documentation

uses: npalm/[email protected]

Learn more about this action in npalm/action-docs-action

Choose a version

action-docs-action status

Action to update action documentation

This action wraps action-docs to update action documentation. By default the action will update README.md based on the the action.yml. See the parameters for changing the defaults.

Usages

The action will update you readme by replacing html comment tags. Add one of more tags based on the following template to your repo: <!-- action-docs-(description | inputs | outputs | runs --> to add the corresponding section.

  • description : to add/update a section with a descriptions of the action
  • inputs: to add/update a section with inputs of the action
  • outpus: to add/update a section with outputs of the action
  • runs: : to add/update a section of the environment required to run.

In your workflow add the action, see below for the available parameters.

      - uses: npalm/action-docs-action

The action will not commit any change, to ensure the changes are persisted you can use an action to commit or raise a pull request.

Inputs

parameter description required default
readme Readme file to update. false README.md
actionFile THe action definition file. false action.yml
tocLevel TOC level used for the headers. false 2
lineBreaks Line breaks to be used in updated readme (LF CR CRLF).

Runs

This action is an node12 action.

License

This project are released under the MIT License.