minor tweaks to initialise process, plus documentation for all the new bits: initialisation and daos