added links and examples to ruby syntax, naming and comments