readme clarifications & formatting
improved debounce