update docs, add spec for nested object reference
add exclude_root option to hash creation