enabling recursive yaml-referencing and some documentation