Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update documentation #34

Merged
merged 3 commits into from
Jul 4, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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