add note in documentation
more clarity and changes