update to adapt to the fact we no longer can install in userspace + improve the documentation on how it works