misc documentation fixes

@fosdev Please review and merge!
@brutski So, I think we should have a test in here where href is a symbol, which @ejennings-mdsol noted was also a requirement for things to work.

Also, outside the scope of this PR, but all the specs under #initialize should use an action verb like 'sets ...' vs. 'returns ...' because initialize does not return those things. We could fix that later I suppose.