I've looked a bit at the API documentation for Rust. I was surprised to see that very often the documentation for a method uses one or more assertions about the returned value, instead of showing the returned value itself.

This contrasts sharply with corresponding documentation for other languages. Does anyone know the motivation for this?

• Rust.
• Ruby (btw, I wrote this one).
• Python.
• Javascript.
• C++.