Spelling: fix "key" to "key_length"

Mostly on bson_append_X documentation pages.
More minor spelling/formatting fixes

I added the definition of the BSON_ITER_HAS_DATE_TIME macro to the
documentation to make it more consistent with the other bson_iter_X
functions.