adds reference container inspired/copied from @donatj
better docs