[doc] swap example code
remove right method forms
[cleanup] clarify test names