added better comments to function examples