How “self-documenting” can code be without being annoying? [closed]

Answer 1

I browsed through the answers, but I don't see if the following is covered. Here it goes...

Whether you abbreviate or being verbose, just ensure that you have used no more words than necessary and the meaning is damn obvious.

But even after this filtering if your identifiers look verbose, you have a flaw in your design.

def initialize_report_template()
end

should have been...

class ReportTemplate
    def initialize()
    end
end