Improve the discussion about middleware and endpoint metadata

Fixes #31