Documentation action

code • November 7, 2022

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:

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.)

Keep reading code