clarifying notes for experienced javascript devs