fix broken navigation

add comments to some parts of the main controller