clarify comments for first half of app.py