Skip to content

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

Merged
merged 5 commits into from
Oct 19, 2018
Merged

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


*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
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`:

@@ -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.
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