Separate Close and Err docs for #62

This is my proposal to fix #62 as highlighted in #61.
"it's unclear..." -> "what the right thing to do is" or "how it should be handled"?