adding "how to use" comments & references