logoalt Hacker News

actionfromafartoday at 11:12 AM2 repliesview on HN

But the documentation can really help in telling why we are doing things. That also seeps in to naming things like classes. If that were not so, we'd just name everything Class1, Class2, Method1, Method2 and so on.


Replies

palatatoday at 11:44 AM

My point is that if your code is well written, it is self-documenting. Obviously Class1 and var2 are not self-documenting.

samplifiertoday at 11:23 AM

def reallyDumbIdeaByManagerWorkaroundMethodToGetCoverageToNinetyPercent(self): """Dont worry, this is a clear description of the method. """ return False

show 1 reply