They are both important- writing well structured code with the right methods and variables names. And document the code as well. One more point: Usually if the code needs a lot of comments, it starts to smell , and this is what you mean I guess :)