Revise instructions

README.md

@@ -67,8 +67,9 @@ Asynchronously run the example from the [ATLAS Exotics Rome Workshop 2018][ATLAS
 python -m pip install --upgrade 'recast-atlas[reana]' coolname
 ```
 
-Authenticate to use the REANA cluster
-```
+Authenticate to use the REANA cluster (remember to clean up later with `eval $(recast auth destroy)`)
+
+```console
 # Set these variables to your personal secret values
 export RECAST_AUTH_USERNAME="<your RECAST auth username>"
 export RECAST_AUTH_PASSWORD="<your RECAST auth password>"
@@ -81,29 +82,34 @@ export REANA_SERVER_URL=https://reana.cern.ch
 export REANA_ACCESS_TOKEN="<your RECAST access token>"
 ```
 
-```
+Submit your RECAST workflow to the REANA cluster
+
+```console
 reana_tag="reana-$(coolname 2)"
 recast submit examples/rome --backend reana --tag "${reana_tag}"
-export REANA_WORKON="recast-${reana_tag}"  # REANA_WORKON is a helper variable that sets workflow automatically
+# REANA_WORKON sets the workflow automatically
+export REANA_WORKON="recast-${reana_tag}"
 ```
 
-Check on the state of the REANA workflow
+Monitor the state of the workflow on REANA
 
-```
+```console
 reana-client status
-# reana-client status --workflow "<use the created tag>"  # if REANA_WORKON not set
+# or if REANA_WORKON not set
+# reana-client status --workflow "<the created tag>"
 ```
 
-Download the results after the workflow succeeds
+The `examples/rome` example doesn't have any result files, but if it did you can download the results after the workflow succeeds
 
-```
+```console
 reana-client download --output-directory output
-# reana-client download --workflow "<use the created tag>" --output-directory output
+# or if REANA_WORKON not set
+# reana-client download --workflow "<the created tag>" --output-directory output
 ```
 
 Clean up the environment of personal information in environmental variables
 
-```
+```console
 eval $(recast auth destroy)
 ```