Draft: [doxygen][highleveldocs] update overview

Notes for the reviewer

I would like to go through the "overview" page and change a few things, but we should definitely discuss a bit first.

These were just a few quick changes that we can talk about tomorrow.