Fixes the rule list to match the function parameter placement with the examples
Changes the examples to match the formating and naming style described. Also some minor typos are fixed.
.
Approved by PS Jenkins bot, Kevin DuBois, Alan Griffiths, Alexandros Frantzis.