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 single real" -> "a scalar value"?