can we add a comment somewhere to explain when to use local vs global?