Docker Clarity (#313)

* docker clarity

* typo fix

Co-authored-by: Peter Amstutz <[email protected]>

Author: smyja

src/faq.md

@@ -246,7 +246,7 @@ inputs:
 <a name="enuminputs"></a>
 ## Enum Inputs ⚜️
 
-For command-line flags that require a specific input as the argument, an enum type can be declared in CWL. **Specifying null here is known as long form style. It does the same thing as the question mark on the other inputs.**
+For command line flags that require a specific input as the argument an enum type can be declared in CWL. **Specifying null here is known as long form style. It does the same thing as the question mark on the other inputs.**
 
 ```yaml
 Format:
@@ -266,7 +266,7 @@ Format:
 <a name="recordinputs"></a>
 ## Record Inputs 📀
 
-For command-line flags that are either **mutually exclusive** or **dependent**, a special record type can be defined. You can also specify null here to create optional inputs.
+For commandline flags that are either **mutually exclusive** or **dependent** a special record type can be defined. You can also specify null here to create optional inputs.
 
 ```yaml
 #Using record inputs to create mutually exclusive inputs

src/topics/using-containers.md

@@ -41,15 +41,15 @@ hints:
     dockerPull: node:slim
 ```
 
-`baseCommand: node` tells CWL that we will be running this command in a container. We
+`baseCommand: node` tells CWL that we will be running this command using the Node Js runtime that is meant for Javascript files. We
 then need to specify some `hints` for how to find the container we want.  In this case we list
 just our requirements for the docker container in `DockerRequirements`.  The `dockerPull:`
 parameter takes the same value that you would pass to a `docker pull` command. That is,
 the name of the container image (you can even specify the tag, which is good idea for
 best practices when using containers for reproducible research). In this case we have
 used a container called `node:slim`.
 
-Provide a "hello.js" and invoke `cwltool` providing the tool description and the
+Create a Javascript file named "hello.js" and invoke `cwltool` providing the tool description and the
 input object on the command line:
 
 ```{literalinclude} /_includes/cwl/using-containers/hello.js