update docs to mention it's a Hash
add a test for default value