GitHub Action
Action to update GitHub 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.
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-(header | description | inputs | outputs | runs -->
to add the corresponding section.
header
: to add/updae a header based on the name of the actiondescription
: to add/update a section with a descriptions of the actioninputs
: to add/update a section with inputs of the actionoutputs
: to add/update a section with outputs of the actionruns
: 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.
name | description | required | default |
---|---|---|---|
readme |
Readme file to update. |
false |
README.md |
actionFile |
THe action definition file. |
false |
action.yml |
includeNameHeader |
Include the name header in the updated readme. |
false |
true |
tocLevel |
TOC level used for the headers. The |
false |
2 |
lineBreaks |
Line breaks to be used in updated readme (LF |
CR | CRLF). |
This action is a node20
action.
This project are released under the MIT License.