docs: refactor summary, configure in docs
Description
This MR moves summary and configure to the right position within the docs, and improves readability.
Definition of Done
-
Documentation is up-to-date.
Code indexing in gitaly is broken and leads to code not being visible to the user. We work on the issue with highest priority.