Update experiment class docstrings to autodoc format

[coruscating]

@nkanazawa1989 will update the RB class as an example, but note that an example already exists at docs/_ext/custom_styles/example/example_experiment.py

RB example: #255

The classes that need to be updated:

• T1
• T2 Ramsey
• Tomography
• QV
• Calibrations

[nkanazawa1989]

See git diff for your reference
https://github.com/Qiskit/qiskit-experiments/pull/255/files

[yaelbh]

@coruscating @nkanazawa1989 Can we close this issue?

[nkanazawa1989]

Yes, thanks @yaelbh