document the code a little bit more