Add f-strings and improve description

[amaliestokholm]

This pull request aims to improve readability of the code. It contains more type hinting, it changes a few variable names and adds some more descriptions.