important clarification on debounce

[mesqueeb]

I spent 1 hour trying to debug this. That's why I improve the docs here so others don't need to go through the same mistake.

[rstoenescu]

Thanks for your contributions! Much appreciate it!