Autoclose docs

See #658 and #622.

The terminology used in this is a little subtle (and I’m not entirely sure I’ve got it right) so this could do with a review before it gets merged.

I’ve put the new doc into [a gist](https://gist.github.com/mattwildig/5305812), where it might be easier to read than the diff.