doc req for newish swift
pull out base to stop pulling in a bunch of cruft
add install/upgrade flags
*really* add the install/upgrade flags
add environment stuff
example environments