-
-
Notifications
You must be signed in to change notification settings - Fork 66
Update 02-1st-example.md #80
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
Conversation
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].
There was a problem hiding this 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
_episodes/02-1st-example.md
Outdated
|
||
*echo-job.yml* | ||
~~~ | ||
{% include cwl/02-1st-example/echo-job.yml %} | ||
~~~ | ||
{: .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 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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 |
_episodes/02-1st-example.md
Outdated
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: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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`: |
_episodes/02-1st-example.md
Outdated
@@ -60,7 +64,7 @@ baseCommand: echo | |||
~~~ | |||
{: .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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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). |
@rmccole could you please look at the suggestions? Otherwise the PR looks great. |
There was a problem hiding this 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.
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].