Structure of tutorials and examples

[thomasrobiglio]

Following the diataxis approach to documentation, I propose the following organization of tutorials and examples.

EXPLANATION -> theoretical explanations as already present here + references (might require checking of the equations + adding some figures)

REFERENCE -> API documentation

TUTORIALS The goal of this part is to guide the user through the structure of the important functions in the toolbox.

• [ ] "Core information theoretical measures" Here the goal is to show how to compute entropy and mutual information. I think a simple case with entropy/MI of univariate Gaussians is ok.
• [x] "Higher-order information theoretical measures" Here we show for a single metric (O-info?) how the hoi.metrics class works. Something very similar to the existing example with RSI. Create a simple data, define the model, fit it, print the best multiplets, and plot the results
• [ ] "Simulation of HOI"

HOW-TO GUIDES -> Examples This consists of a gallery of examples (one per metric?) showing the computation of the given metric on simple data (similar to what is done in the corresponding tutorial but with shorter descriptions).

• [ ] Oinfo
• [ ] InfoTopo
• [ ] TC
• [ ] DTC
• [ ] Sinfo
• [ ] GradientOinfo
• [ ] RSI
• [ ] RedundancyMMI
• [ ] SynergyMMI
• [ ] InfoTot