Clarify some text, fix a bad field name in settings

@cheddar -- these are a couple of changes I came up with while building a driver.
If we are changing the type name, should we call that out in the doc too?

Also, should I be expecting a PR on jellyfish to cover this type?  (Should it maybe be a subType instead?  "normal_completed", etc?)