If you check out [TomDoc](http://tomdoc.org), it has great examples for ways to document methods and classes. Documentation is as important as code, because it makes our projects more maintainable - new developers can use our code more easily, and code that we wrote so long ago that we don't even remember writing it similarly becomes easier to use.