add commets to describe global variables which are passed from template