commit 2

put more inline comments