[DOCS] minor enhancements in docs after Sydney's review

[zhao-cy]

I will add more things:

(point 1-3 are from my notes in PR #103)

1. add a bit more docs re: what if BABS functions fail, e.g.,:

• singularity run command is not what the user want
• Cluster resources are not what the user want
• What if babs-init fails: integrate these two versions together: version in babs-init.rst + “create_babs_project.rst”

2. Example customized_text for Slurm clusters, using partition request as examples: #SBATCH -p <partition_name>.

• add this to: preparation_config_yaml_file.rst#cluster-resources.
• add this to the example walkthrough too.

4. BABS (only) works on SGE and Slurm HPC clusters. Not designed to be run on local computers as there is no job scheduler system or singularity software.

5. Sydney's comments in PR [DOCS/ENH] Documentation enhancement and review #103, not those "suggested changes" that are ready to commit

6. If the input dataset is zipped derivatives, the name of the input dataset should NOT include -. Otherwise, when generating participant_job.sh, the variable e.g., FMRIPREP-ANAT_ZIP won't be valid for bash script.

• So be careful when you name the output folder to create under zip_foldernames, if you will use the zip derivatives as input dataset of the next step. This is because you'll use the same string for input dataset of zip derivatives as the output foldername you're giving now.

7. If compute nodes do not have access to internet:

• Update example walkthrough: get the data content first + use path to the cloned dataset - has been done in PR [DOC] add guides in eg walkthrough: if there is no internet on compute nodes #121
• Add to other parts of docs too