I am not a big fan of commenting my code. I really am not. So when we took the decision to comment our app source code with YARD, I was not very happy. In my opinion, a comment is about to be outdated and misleading soon.

Code doesn’t lie. If you understand the code, you don’t need these comments...

We have a Rails application which starts to be larger and larger. In order to navigate easily between the different files we have, I like to use tags. It allows for instance to jump directly to the definition of a class or a method living in another part of the codebase, whithout having to navigate...