Generate documentation from actions.yml #1239
Open
+158
−90
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description:
Right now inputs and outputs of an action are documented in
actions.yml
but this is not the first place a userlooks at. To have valid documentation inside
README.md
a section inside the README seems to be manuallymaintained and kept in sync with the
actions.yml
file.Since I was facing a similar issue I assume you are facing here, I developed github-actions-docs and I am wondering wether this would be helpful for you as well.
This PR now introduces github-actions-docs to automatically generate documentation of inputs and outputs.
It can be used to update documentation when running
NOTE: This commit seems to introduce change to the
dist/
directory after runningnpm run pre-checkin
. I am not exactly sure why this is, I assume this is partially due to a bump intslib
but I also see CRLF->LF changes which also happen for me on a clear git checkout. Let me know if you want to dig deeper into this.Related issue:
Add link to the related issue.
Check list: