docs: improve usage and parameter descriptions

This commit is contained in:
ok-nick 2023-02-10 22:28:16 -05:00 committed by GitHub
commit eae72f5e6a
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -9,17 +9,23 @@
GitHub action to install and run [aftman](https://github.com/LPGhatguy/aftman); a toolchain manager. GitHub action to install and run [aftman](https://github.com/LPGhatguy/aftman); a toolchain manager.
## Usage ## Usage
This is the most common case and automatically provides all the parameters using the latest released version of `aftman`.
```yaml ```yaml
steps: steps:
- uses: ok-nick/setup-aftman@v0.3.0 - uses: ok-nick/setup-aftman@v0.3.0
``` ```
For a list of default parameter values, [check here](https://github.com/ok-nick/setup-aftman/blob/main/action.yml#L5-L25).
### Parameters ### Advanced Usage
|name|description|default| For more advanced cases, use the parameters below.
|---|---|---| ```yaml
|`version`|`aftman` version in the form `vx.x.x`|-| steps:
|`path`|Path to the `aftman.toml` directory|`.`| - uses: ok-nick/setup-aftman@v0.3.0
|`token`|Github token from `github.token`|`github.token`| with:
version: v1.0.0 # name of git tag
path: some_directory/my_project # path to project directory containing `aftman.toml`
token: ${{ github.token }} # GitHub token to bypass rate limit
```
## Credits ## Credits
[@nezuo](https://github.com/nezuo) - Installing `aftman` using `gh` [@nezuo](https://github.com/nezuo) - Installing `aftman` using `gh`