Added inline documentation to the DocumentServiceConnection

This is some updated inline documentation for DocumentServiceConnection.

It attempts to explain better the interaction between `<add>`/`<delete>` and `<get_sdf>`/`<add_sdf_from_s3>`, as well as using `<commit>` and `<clear_sdf>`.