install: upgrade pip/setuptools/wheel first

Author: mr-c

CONTRIBUTING.md

@@ -101,11 +101,13 @@ in `Makefile`).
 # Create and activate a virtual environment
 python -m venv venv
 source venv/bin/activate
+# update the version of pip, setuptools, and wheel
+(venv) pip -U pip setuptools wheel
 # Install the dependencies in your virtual environment
-(venv) python -mpip install .[all]
+(venv) pip install .[all]
 # Create the HTML to visualize locally
 (venv) make html
-(venv) firefox _build/index.html
+(venv) open _build/index.html
 # Or you can start a serve that watches for local file changes
 (venv) make watch
 # Open <http://localhost:8000/> in your browser

src/introduction/prerequisites.md

@@ -54,11 +54,12 @@ environment:
 
 $ python -m venv venv
 $ source venv/bin/activate
+$ (venv) pip install -U pip setuptools wheel
 $ (venv) pip install cwltool
 ```
 
 ```{note}
-You can find the `cwl-runner` source code [here](https://github.com/common-workflow-language/cwltool/tree/main/cwlref-runner).  
+You can find the `cwl-runner` source code [here](https://github.com/common-workflow-language/cwltool/tree/main/cwlref-runner).
 Visit the `cwltool` [documentation](https://github.com/common-workflow-language/cwltool#install)
 for other ways to install `cwltool` with `apt` and `conda`.
 ```