transformation is set to empty dict instead of None, added defaults section to docs, needs to be filled in future
