Document middle (fix #8833)

This an attempt to fix #8833 issue by documenting `middle`. It's my first pull request, so I hope it's ok.

Rémi

"a couple" -> "two"

Also, why does this method exist? It's the only two-argument dispatch, so it's not needed for generic-ness.