Tidy up some small parts that were confusing a new user

Small ammendments
Looks good meaning you are going to move it out of the code block to comment on the kind of input that Revel expects for the 2nd argument?