Documentation improvements

[AnesBenmerzoug]

After conducting user interviews, we realized that the current documentation has some issues and that those should be resolved because it is the the most used source of information for users.

We could have a look at the lakefs-spec documentation and use parts of it as inspiration.

General

• Move list of papers to documentation #514
• Make it easier to find the examples.
• Create separate page for glossary of terms #534
• Fix broken references and math in valuation module #524
• Fix broken references and math in influences module #525

First Steps

• Caching documentation should be consolidated into one page/section. #517
• Add code snippets showing how to use caching. #535
• Add code snippets showing how to use parallelization. #536

Example

• Show binder link more prominently.

[AnesBenmerzoug]

Closing this issue in favour of smaller ones.