An open API service indexing awesome lists of open source software.

https://github.com/rawnly/github-actions-autodocs


https://github.com/rawnly/github-actions-autodocs

Last synced: 7 months ago
JSON representation

Awesome Lists containing this project

README

          

# Github Actions Autodocs (GCA)

Generate a basic readme for the given github action

## Installation

Install via cargo

```sh
cargo install github-actions-autodocs
```

## Usage

```sh
Usage: github-actions-autodocs [OPTIONS]

Options:
-f, --file Source path [default: action.yml]
--dry Dry run
-o, --output Output filepath
-h, --help Print help
-V, --version Print version
```

## Github Action

```yaml
name: Generate Readme

on:
push:

jobs:
generate:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: rawnly/github-actions-autodocs@main
with:
action-file: action.yml
- shell: bash
run: |
git add -A .
git commit -m 'docs: README'
git push -u origin ${{ github.ref }}
```

> TIP: Alias `github-actions-autodocs` to `gca` 😉

### LICENSE

The MIT License