Skip to content

Conversation

@rmccole
Copy link
Contributor

@rmccole rmccole commented Jan 19, 2018

I added extra explanations about echo and the contents of the files the tutorial user should make, and the command they will execute.

I simplified the text about 'use a YAML or JSON object in a separate file' as it is very opaque to a beginner and didn't seem immediately relevant.

I included an explanation of how the specific command used here (cwl-runner 1st-tool.cwl echo-job.yml) is an example of the general form cwl-runner [tool-or-workflow-description] [input-job-settings].

I added extra explanations about echo and the contents of the files the tutorial user should make, and the command they will execute. 

I simplified the text about 'use a YAML or JSON object in a separate file' as it is very opaque to a beginner and didn't seem immediately relevant. 

I included an explanation of how the specific command used here (cwl-runner 1st-tool.cwl echo-job.yml) is an example of the general form cwl-runner [tool-or-workflow-description] [input-job-settings].
@mr-c mr-c requested a review from tobyhodges January 19, 2018 21:41
ghost
ghost previously approved these changes Oct 17, 2018
Copy link

@ghost ghost left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All the changes add extra useful information

{: .source}

Now, invoke `cwl-runner` with the tool wrapper and the input object on the command line:
Now, invoke `cwl-runner` with the tool wrapper 1st-too.cwl and the input object echo-job.yml on the command line. The command is
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Now, invoke `cwl-runner` with the tool wrapper 1st-too.cwl and the input object echo-job.yml on the command line. The command is
Now, invoke `cwl-runner` with the tool wrapper `1st-tool.cwl` and the input object `echo-job.yml` on the command line. The command is

The command `cwl-runner 1st-tool.cwl echo-job.yml` is an example of a general form that you will often come across while using CWL. The general form is:
`cwl-runner [tool-or-workflow-description] [input-job-settings]`

What's going on here? Let's break down the contents of 1st-tool.cwl:
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
What's going on here? Let's break down the contents of 1st-tool.cwl:
What's going on here? Let's break down the contents of `1st-tool.cwl`:

{: .source}

The `baseCommand` provides the name of program that will actually run (`echo`)
The `baseCommand` provides the name of program that will actually run (`echo`). [echo] is a built-in program in the bash and C shells.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The `baseCommand` provides the name of program that will actually run (`echo`). [echo] is a built-in program in the bash and C shells.
The `baseCommand` provides the name of program that will actually run (`[echo]` in this case, which is a built-in program in the bash and C shells).

@ghost
Copy link

ghost commented Oct 17, 2018

@rmccole could you please look at the suggestions? Otherwise the PR looks great.

@ghost ghost dismissed their stale review via ec62f3a October 19, 2018 11:46
ghost
ghost previously approved these changes Oct 19, 2018
Copy link

@ghost ghost left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All the changes add extra useful information.

@mr-c mr-c dismissed ghost ’s stale review via 6a524a4 October 19, 2018 16:22
@mr-c mr-c merged commit ba35fb4 into common-workflow-language:gh-pages Oct 19, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants