[REQS-383] Improved documentation on worked-out example for curve calibration.
[REQS-383] Added more worked-out examples for curve calibration. Clean comments on more involved examples.