Skip to content

Commit

Permalink
Update documentation (#34)
Browse files Browse the repository at this point in the history
* refactor changelog

* update actions

* update pr number
  • Loading branch information
rcannood authored Jul 4, 2024
1 parent 3559a23 commit a15ad33
Show file tree
Hide file tree
Showing 8 changed files with 21 additions and 27 deletions.
7 changes: 5 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# viash-actions v6.0.1
# viash-actions v6.1.0

## New functionality

* `sync-and-cache`: Added an action for syncing and caching test resources (PR #31).
* `project/sync-and-cache`: Added an action for syncing and caching test resources (PR #31).

## Minor changes

Expand All @@ -12,10 +12,13 @@

* `project/detect-changed-components`: Output the `full_name` and `main_script_type` of each component (PR #33).

* Update documentation for various components (PR #34).

## Bug fixes

* `check-concurrent-pr`: Added input parameter `github_token` for checking concurrent PRs (PR #31).


# viash-actions v6.0.0

## Breaking changes
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,11 +27,11 @@ Finally, there are some [Viash
Pro](https://www.data-intuitive.com/services/viashpro.html) actions:

1. [`pro/build-nextflow-params`](pro/build-nextflow-params) - Build
parameter yaml
parameter yaml examples for Viash components
2. [`pro/build-nextflow-schemas`](pro/build-nextflow-schemas) - Build
nf-tower schemas
nf-tower schemas for Viash components
3. [`pro/generate-documentation-qmd`](pro/generate-documentation-qmd) -
Build and publish qmd
Build quarto markdown documentation files for Viash components

We recommend using `v6` for your actions.

Expand Down
5 changes: 1 addition & 4 deletions pro/build-nextflow-params/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,6 @@ This README was generated by running `make`

This action will build nextflow parameter file templates (see nextflow’s
-params-file option) for Viash workflows and components in a repository.
For workflows, will save the build parameter files next to the Viash
config. For components, will output to the target directory (see viash
ns build).

### Inputs available

Expand Down Expand Up @@ -42,7 +39,7 @@ jobs:
- name: Check out repository
uses: actions/checkout@v3

- name: Build parameter yaml
- name: Build parameter yaml examples for Viash components
uses: viash-io/viash-actions/pro/build-nextflow-params@v6
with:
target: target/
Expand Down
4 changes: 1 addition & 3 deletions pro/build-nextflow-params/action.yml
Original file line number Diff line number Diff line change
@@ -1,10 +1,8 @@
name: 'Build parameter yaml'
name: 'Build parameter yaml examples for Viash components'
author: Data Intuitive
description: >
This action will build nextflow parameter file templates
(see nextflow's -params-file option) for Viash workflows and components in a repository.
For workflows, will save the build parameter files next to the Viash config.
For components, will output to the target directory (see viash ns build).
inputs:
target_dir:
required: false
Expand Down
6 changes: 2 additions & 4 deletions pro/build-nextflow-schemas/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,7 @@ This README was generated by running `make`
-->

This action will build nextflow schemas for Viash workflows and
components in a repository. For workflows, will save the build schemas
next to the Viash config. For components, will output to the target
directory (see viash ns build).
components in a repository.

### Inputs available

Expand Down Expand Up @@ -43,7 +41,7 @@ jobs:
- name: Check out repository
uses: actions/checkout@v3

- name: Build nf-tower schemas
- name: Build nf-tower schemas for Viash components
uses: viash-io/viash-actions/pro/build-nextflow-schemas@v6
with:
target: target/
Expand Down
4 changes: 1 addition & 3 deletions pro/build-nextflow-schemas/action.yml
Original file line number Diff line number Diff line change
@@ -1,9 +1,7 @@
name: 'Build nf-tower schemas'
name: 'Build nf-tower schemas for Viash components'
author: Data Intuitive
description: >
This action will build nextflow schemas for Viash workflows and components in a repository.
For workflows, will save the build schemas next to the Viash config.
For components, will output to the target directory (see viash ns build).
inputs:
target_dir:
required: false
Expand Down
8 changes: 4 additions & 4 deletions pro/generate-documentation-qmd/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,12 +7,12 @@ DO NOT EDIT THIS FILE MANUALLY!
This README was generated by running `make`
-->

Create quarto markdown files for viash components or workflows, based on
Create quarto markdown files for Viash components or workflows, based on
a jinja template.

This action will look for viash configs for workflows and components in
This action will look for Viash configs for workflows and components in
a directory, and will apply information for each of these configs to a
jinja template to generate qmd files. This component required Viash to
jinja template to generate qmd files. This component requires Viash to
be installed and available in `$PATH`.

We recommend to use
Expand Down Expand Up @@ -71,7 +71,7 @@ jobs:
with:
path: project

- name: Build and publish qmd
- name: Build quarto markdown documentation files for Viash components
uses: viash-io/viash-actions/generate-documentation-qmd@v6
with:
project_dir: project
Expand Down
8 changes: 4 additions & 4 deletions pro/generate-documentation-qmd/action.yml
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
name: 'Build and publish qmd'
name: 'Build quarto markdown documentation files for Viash components'
author: 'Dries Schaumont'
description: |
Create quarto markdown files for viash components or workflows, based on a jinja template.
Create quarto markdown files for Viash components or workflows, based on a jinja template.
This action will look for viash configs for workflows and components in a directory,
This action will look for Viash configs for workflows and components in a directory,
and will apply information for each of these configs to a jinja template to generate qmd files.
This component required Viash to be installed and available in `$PATH`.
This component requires Viash to be installed and available in `$PATH`.
We recommend to use [viash-actions/setup](https://github.com/viash-io/viash-actions/tree/main/setup) before you run `generate_documentation_qmd`.
inputs:
Expand Down

0 comments on commit a15ad33

Please sign in to comment.