Add proper protocols documentation

[andrea-pasquale]

This PR aims at providing a comprehensible documentation for all protocols available in qibocal.

TODOs:

• Use autoclass to show Parameters in the same page
• Add single page with references

Protocols:

• qubit spectroscopy
• qubit spectroscopy ef
• ramsey
• ramsey signal
• t1
• t1_signal
• t1_sequences
• t2
• t2_signal
• t2_sequences
• kernel
• tof
• qubit_flux_dependence
• resonator_flux_dependence
• qubit_tracking
• rabis More docs #868
• single shots More docs #868
• dispersive shift More docs #868
• flipping More docs #868
• allxy More docs #868

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 97.32%. Comparing base (b0c0ef7) to head (ab4e61b).
Report is 64 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #861      +/-   ##
==========================================
- Coverage   97.40%   97.32%   -0.09%     
==========================================
  Files         115      115              
  Lines        8645     8645              
==========================================
- Hits         8421     8414       -7     
- Misses        224      231       +7     

Flag	Coverage Δ
unittests	97.32% <100.00%> (-0.09%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files	Coverage Δ
src/qibocal/protocols/classification.py	100.00% <ø> (ø)
src/qibocal/protocols/coherence/t2.py	94.02% <ø> (ø)
src/qibocal/protocols/coherence/t2_signal.py	100.00% <ø> (ø)
src/qibocal/protocols/qubit_spectroscopy_ef.py	98.52% <100.00%> (ø)
src/qibocal/protocols/ramsey/ramsey.py	99.08% <ø> (ø)
src/qibocal/protocols/ramsey/ramsey_signal.py	97.63% <ø> (ø)

... and 3 files with indirect coverage changes

[rodolfocarobene]

Thanks @andrea-pasquale and @Edoardo-Pedicillo!
When compiling the documentation, when a protocol has the bibliography there is some layout problem and sphinx complains that entries are repeated... A possible solution could maybe to have a single page with all the references (?) not sure

[andrea-pasquale]

Thanks @andrea-pasquale and @Edoardo-Pedicillo! When compiling the documentation, when a protocol has the bibliography there is some layout problem and sphinx complains that entries are repeated... A possible solution could maybe to have a single page with all the references (?) not sure

Yes, we know. We are planning to move to a single page with all references. I'm not sure if this will fix the issue. We need to have a look into sphinx.

[andrea-pasquale]

@rodolfocarobene @Edoardo-Pedicillo if you have further comments let me know. I would like to merge this PR today.

[rodolfocarobene]

LGTM !

[andrea-pasquale]

I'll merge now. Thanks everyone for contributing and reviewing.