Simulator doc update (#3955)

This PR contains a bundle of little updates for the simulator doc, including:
- Links to code for the simulator result types
- New section for `simulate_expectation_values` (with examples)
- Suggested workaround for stepping through circuits