Provide access to the implementation details for Calibration

Extends the documentation to parse the code inside the methods
that implements the calibration and the objects related to it.

re #7496
Merge remote-tracking branch 'origin/feature/7496_detailed_doc_calib'