Clarify/fix bubbling docs, fixes #229