Yup, I’ve also come across this inconsistency between docu and implementation (as well as the apparent and undocumented possibility that Particle.function() seems allow handlers to return float - found in another thread).
Would be good if @rickkas7 could chime in on that 
I wonder how many other changes got introduced but slipped through the cracks 