I would not put an example of clean here, without an explanation of what it does and/or when to use it.
I could see a make beginner stumbling upon it and getting stuck in a "It says its 'useful'. Why isn't it working?" loop. Especially since this is going into ReadTheDocs.
(This probably happened to me, and I've suppressed the memory.)
