A Wonderful Example of Comments Causing Problems

Current thinking is that comments in code should be helpful and should only document why and not how, that is what the code is for. That wasn’t always the case, for example

$courseNick = $_POST[‘courseNick’]; //Course nick
$phone = $_POST[‘phone’]; //Course nick

See how useless that is?