Resolve "Improve_observables_doc_and_code"

Fakher F. Assaadrequested to merge
267-improve_observables_doc_and_code into master

Closes #267 (closed) Closes #266 (closed)

Edited by Francesco Parisen Toldin

Merge request reports