diff --git a/Process.yml b/Process.yml
index ec1d1ba..54bda65 100644
--- a/Process.yml
+++ b/Process.yml
@@ -939,6 +939,20 @@ $graph:
         set to `false` and the expected secondary file does not exist.
         Default value for `required` field is `true` for secondary files on
         input and `false` for secondary files on output.
+  doc: |
+    Secondary files are specified using the following micro-DSL for secondary files:
+
+    * If the value is a string, it is transformed to an object with two fields 
+      `pattern` and `required`
+    * By default, the value of `required` is `null` 
+      (this indicates default behavior, which may be based on the context)
+    * If the value ends with a question mark `?` the question mark is
+      stripped off and the value of the field `required` is set to `False`
+    * The remaining value is assigned to the field `pattern` 
+    
+    For implementation details and examples, please see 
+    [this section](SchemaSalad.html#Domain_Specific_Language_for_secondary_files) 
+    in the Schema Salad specification.
 
 - name: LoadListingRequirement
   type: record
diff --git a/Workflow.yml b/Workflow.yml
index f6c58e6..7e8217e 100644
--- a/Workflow.yml
+++ b/Workflow.yml
@@ -103,8 +103,8 @@ $graph:
           contain either a non-string value accepted by the field
           type, or a valid expression which returns a value having one
           of the the other types defined for that field.
-        * [WorkflowStepInput](WorkflowStepInput) now has a `loadContents` field.
-        * [WorkflowStepInput.id](WorkflowStepInput) field value does not have to match an
+        * [WorkflowStepInput](#WorkflowStepInput) now has a `loadContents` field.
+        * [WorkflowStepInput.id](#WorkflowStepInput) field value does not have to match an
           `input.id` value from the process specified in the `run` field.
 
       See also the [CWL Command Line Tool Description, v1.1 changelog](CommandLineTool.html#Changelog).
diff --git a/salad/schema_salad/metaschema/sfdsl_res.yml b/salad/schema_salad/metaschema/sfdsl_res.yml
index f619495..871b8e0 100644
--- a/salad/schema_salad/metaschema/sfdsl_res.yml
+++ b/salad/schema_salad/metaschema/sfdsl_res.yml
@@ -10,7 +10,7 @@
     stripped off and the value of the field `required` is set to `False`
   * The remaining value is assigned to the field `pattern`
 
-  ### Type DSL example
+  ### Secondary files DSL example
 
   Given the following schema: