Documentation - first batch

[alecandido]

• Next thing to do: label each formula with reference, in the code docstring.

Source

Module to document:

• runner
• structure_functions
• structure_functions/EvaluatedStructureFunctions
• structure_functions/{F2,FL}
• structure_functions/convolution

Test

Test collections:

• against_apfel
• convolution

Sphinx

Documentation structure:

• home
• variable definition
• room for long module descriptions

More & misc

...

[alecandido]

• Find a way with graphviz to put edges without moving positions of nodes (F2-FL same level of StructureFunction, but they inherit from it)
• make clear the interface level correspond to the underlying implementation
  • at the level of EvaluatedStructureFunctions the kinematics is known, so it is possible to compute the coefficient functions explicitly, and it is done, but it is never exposed, since Runner interacts through StructureFunctions instead
• make sure that the edges style is consistent (inheritance, interface, member, ...)

[alecandido]

The current branch was outdated, now is synced with master.

However, since it is better to break also documentation upgrades in small focused PRs, I am going to merge this one.

The achieved goals are to almost completely document convolution API (missing a theoretical part on how the integration is performed) and ESF's one.