Improve readability by adding/changing inline documentation
Signed-off-by: NArthur Borsboom <arthurborsboom@gmail.com>
Signed-off-by: NPatrik Jakobsson <patrik.r.jakobsson@gmail.com>