Documentation action
Earlier this year, I created documentation action to automatically generate documentation for my GitHub Actions.
The action requires a sample workflow, a markdown file (like README.md) to
write the documentation, and the action configuration file (action.yml).
Once you add documentation action to your action’s repository, it will generate and keep up-to-date:
- How to set up the workflow. This includes short instructions and a ready to copy and paste sample workflow.
- Action options. A list of all input options, if they exist.
- Workflow dispatch options. The payload object for actions that use a workflow dispatch event.
In the sample workflow for documentation action, the action will trigger if any
of the following files, .github/workflows/example.yml, action.yml,
package.json, and README.md, since these files are the source for the
documentation. If there’s a diff, then the action will generate and commit the
documentation.
The documentation action may not cover all action use cases yet. (It mostly it covers what I have built with actions so far.)