added comments to guide development