Convert faq headings to questions (#358)

* change FAQ heading 3 to question

* change FAQ heading 4 to question

* change FAQ heading 5 to question

* change faq 6 to heading

* change faq 7 to heading

* change faq 8 to heading

* change faq 9 to heading

* change faq 10 to heading

* modify faq 9

* change faq 11 heading to question

* change faq 12 heading to question

* change faq 13 heading to question

* change faq 14 & 15 headings to questions

* change faq 16 heading to question

* change faq 1 heading to question

* adust punctuation and capitalisation

* updates from review

---------

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

Author: Fienne

src/faq.md

@@ -8,7 +8,7 @@
 :backlinks: "top"
 ```
 
-## Non "`File`" Types Using `evalFrom`
+## How do I create non "`File`" types using `evalFrom`?
 
 ```yaml
 cwlVersion: v1.0  # or v1.1
@@ -38,7 +38,7 @@ outputs:
        outputEval: $(self[0].contents)
 ```
 
-## Rename an Input File
+## How do I rename an input file?
 
 This example demonstrates how to change the name of an input file
 as part of a tool description.
@@ -56,7 +56,7 @@ requirements:
         entryName: $(inputs.src1.basename)_custom_extension
 ```
 
-## Rename an Output File
+## How do I rename an output file?
 
 This example demonstrates how to change the name of an output file
 from the default name given to it by a tool:
@@ -79,7 +79,7 @@ outputs:
       outputEval: ${self[0].basename=inputs.otu_table_name; return self;}
 ```
 
-## Referencing a Local Script
+## How do I reference a local script?
 
 There are two ways to reference a local script:
 
@@ -135,7 +135,7 @@ outputs: []
 In CWL, everything must be directly stated.
 ```
 
-## Setting `self`-based Input Bindings for Optional Inputs
+## How can I set `self`-based input bindings for optional inputs?
 
 Currently, `cwltool` can't cope with missing optional inputs if their
 input binding makes use of `self`.
@@ -162,7 +162,7 @@ baseCommand: echo
 outputs: []
 ```
 
-## Model a "one-or-the-other" Parameter
+## How can I model a "one-or-the-other" parameter?
 
 Below is an example showing how
 to specify different strings to be added to a command line,
@@ -185,7 +185,7 @@ baseCommand: echo
 outputs: []
 ```
 
-## Connect a Solo Value to an Input that Expects an Array of that Type
+## How do I connect a solo value to an input that expects an array of that type?
 
 Using [`MultipleInputFeatureRequirement`](https://www.commonwl.org/v1.0/Workflow.html#MultipleInputFeatureRequirement)
 along with
@@ -226,7 +226,7 @@ outputs:
     type: File
     outputSource: first/txt
 ```
-## Optional Inputs 💯
+## How do make an input optional? 💯
 
 To make an input parameter optional, add a question mark to the type declaration.
 
@@ -245,7 +245,7 @@ inputs:
       prefix: "--casava"
 ```
 <a name="enuminputs"></a>
-## Enum Inputs ⚜️
+## How do I specify an input that must come from a list of predefined values (i.e. How do I use 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.**
 
@@ -265,7 +265,7 @@ Format:
     prefix: "--format"
 ```
 <a name="recordinputs"></a>
-## Record Inputs 📀
+## How do I describe dependent or exclusive input parameters(e.g. How do I use record 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.
 
@@ -319,7 +319,7 @@ For commandline flags that are either **mutually exclusive** or **dependent** a
             inputBinding:
               prefix: "--chromosomes"
 ```
-## Setting Mutually Exclusive Parameters
+## How do I set mutually exclusive parameters?
 
 To properly set fields in a record input type, you need to pass a dictionary to the input to properly set the parameters. This is done by using inline JavaScript and returning the dictionary with the key of the field you want to set. The source field is set to indicate the input from the workflow to be used as the value.
 
@@ -339,14 +339,14 @@ steps:
     out: [indexes]
 ```
 
-## Setting Booleans
+## How can I set Booleans?
 
 These can be set by using the default field
 ```yaml
 input:
   default:true
 ```
-## Concatenating Strings in Inputs
+## What should I do when concatenating strings in inputs?
 
 The valueFrom field must be used instead of default.
 
@@ -356,7 +356,7 @@ input:
      My String: $(input.stringvalue)
 ```
 
-## `cwltool` Errors due to Filenames with Space Characters Inside
+## I get `cwltool` errors due to filenames with space characters inside. What should I do?
 
 `cwltool` does not allow some characters in filenames by default.
 
@@ -370,7 +370,7 @@ Invalid filename: 'a space is here.txt' contains illegal characters
 
 If you can not avoid these dangerous characters, then pass `--relax-path-checks` to `cwltool`.
 
-## CWL Parameter Reference Error due to Hyphen in Input Identifier
+## What should I do when I get CWL Parameter Reference error due to hyphen in an input identifier?
 
 If `cwltool --validate` returns valid
 
@@ -439,15 +439,15 @@ If it is not possible to change the input identifier, then you can use an altern
 valueFrom: $(inputs["sample-input"])
 ```
 
-## Use CWL and cwltool with Singularity
+## How do I use CWL and cwltool with Singularity?
 
 <!-- https://matrix.to/#/!RQMxrGNGkeDmWHOaEs:gitter.im/$f1B-ytoep4PX3_tTgxaADRQFHGgisGiUL1nUHVQPBnY?via=gitter.im&via=matrix.org&via=gottliebtfreitag.de -->
 The CWL standards are built around (optional) Docker format containers.
 The reference runner and several other CWL implementations support running
 those Docker format containers using the Singularity engine. Directly
 specifying a Singularity format container is not part of the CWL standards.
 
-## Debug JavaScript Expressions
+## How do I debug the JavaScript in my CWL tool?
 
 You can use the <code>--js-console</code> option of <code>cwltool</code>, or you can try
 creating a JavaScript or TypeScript project for your code, and load it