revise the text

Author: SarahAlidoost

_episodes/04-recipe.md

@@ -189,12 +189,14 @@ Please note the following sections:
 > ## config-references.yml and references
 >
 > The values for the keys ``author``, ``maintainer``, ``projects`` and
-> ``references`` in the recipe should be known by ESMValTool. A list of ESMValTool
+> ``references`` in the recipe should be known by ESMValTool:
+>
+> - A list of ESMValTool
 > author, maintainer, and projects are mentioned in the file ``config-references.yml``
 > that can be found in
 > [ESMValTool/esmvaltool](https://github.com/ESMValGroup/ESMValTool/blob/master/esmvaltool/config-references.yml).
 >
-> ESMValTool references in `BibTeX` format can be found in
+> - ESMValTool references in `BibTeX` format can be found in
 > [ESMValTool/esmvaltool/references](https://github.com/ESMValGroup/ESMValTool/tree/master/esmvaltool/references) directory.
 {: .callout}
 

_episodes/06-debugging.md

@@ -214,15 +214,12 @@ attach the run/recipe_*.yml and run/main_log_debug.txt files from the output dir
 {: .error}
 
 The values for the keys ``author``, ``maintainer``, ``projects`` and
-``references`` in the recipe should be known by ESMValTool. A list of ESMValTool
-author, maintainer, and projects can be found in the
-[config-references.yml](https://github.com/ESMValGroup/ESMValTool/blob/master/esmvaltool/config-references.yml). 
+``references`` in the recipe should be known by ESMValTool:
 
-~~~bash
-  wget https://github.com/ESMValGroup/ESMValTool/blob/master/esmvaltool/config-references.yml
-~~~
-
-And ESMValTool references in `BibTeX` format can be found
+- A list of ESMValTool
+author, maintainer, and projects can be found in the
+[config-references.yml](https://github.com/ESMValGroup/ESMValTool/blob/master/esmvaltool/config-references.yml).
+- ESMValTool references in `BibTeX` format can be found in the
 [ESMValTool/esmvaltool/references](https://github.com/ESMValGroup/ESMValTool/tree/master/esmvaltool/references) directory.
 
 > ## ESMValTool can’t locate the data