We'll go first >
"Good code is self-documenting"
What would you add?
We'll go first >
"Good code is self-documenting"
What would you add?
For further actions, you may consider blocking this person and/or reporting abuse
Otto Kekalainen -
Jose RodrΓguez -
Sloan the DEV Moderator -
dev.to staff -
Oldest comments (29)
I according to me this is the advice I often hear that I definitely ignore:
If your change is small enough there's no need to test.
"Smallness" is definitely not the proper litmus test.
And if you don't want that small change to break later, a regression test couldn't possibly hurt, right?
Yeah, absolutely!!
Yes same lol! for example if I'm making scripts in python and I change to add a print statement with colour I always run the program to make sure it works as I want it to.
The "good code" can definitely be self-documenting to some extent. There can be exceptions of course.
Seriously. I find most projects built with TS are pretty much self documenting. There are obviously more factors, but a well typed project will get you 90% of the way.
Any super duper opinionated advice on which software to choose for a problem.
A good suggestion is always useful β but when it's approached with an outside amount of conviction, one should take that with a grain of salt. The advice often lacks context.
Dogma which is complemented by dogmatic backlashes to the original dogma: A software story.
"X is dead. You should probably find a hot new thing to learn."
Any advice about documentation that does not include ongoing structure and discipline.
Maintaining good docs is inherently pretty difficult, and there is no magical solution. Good documentation is a matter of a number of combinatory factors that can lead to success, there is no silver bullet.
Why donβt you code code it yourself instead of complaining about that library or whatever-the-heck you called it?
Uh, because complaining is fun, and it will take me an extra 100 years to code it myselfβ¦
Advice to ignore: "You should not use Dev.to like you use Twitter" ^^
Most
"Learn X, it's faster and better than Y"
The missing part is that X is something of a hyped POC, with virtually no real project using it, with less DX than Y, while Y is battle-tested and there's no real reason to change it expect for hype and some weird scenarios.
That's scary! π¨
If it works then don't touch it.
No - "Good code is self-documenting" is a basic truth, up to a point ... it's a useful guideline, if not taken too far (sometimes you do need to write comments).
Inheritance is for prototypes & interfaces. Encapsulation / pass through constructor or function, is great at decoupling code