more rewording
collapse duplicated code, and get some comments in there
relocated the pool spinup step, and added docstrings and comments