DEV Community

Cover image for It Took Me 20+ Years To Learn This Lesson About Dev

It Took Me 20+ Years To Learn This Lesson About Dev

Matt Butcher on May 01, 2024

I started my software development career as a web developer. I worked at companies large and small, including stints at HP and Google. At Microsoft...
Collapse
 
pavelee profile image
Paweł Ciosek

Great post! 👏👏

Do you have any advice how to build a good documentation? 📃

Collapse
 
momodev profile image
Santiago G. Marín

If you use code comments, you can also use a tool to convert code comments into docs (like JSDoc or TSDoc) and I have to say that Copilot does a great job describing functionality at code level.

It's also a good practice to have PRDs and Tech Specs describing the whys and hows. Notion is particularly helpful at that.

Collapse
 
michaeltharrington profile image
Michael Tharrington

Great post, Matt! Lots of awesome advice in here. 🙌

Collapse
 
emmjayp profile image
Michael Pollaci

Fantastic!

Collapse
 
jaustinuf profile image
jaustinUF

Anyone blogging about writing code today should (at least) mention that we (humans) won’t be writing code for much longer.

However, the concepts here are useful to consider when translated into the future: just replace ‘code/coding’ with ‘system description/design.’ Anytime I’m wring code I’m thinking about how ‘this’ would be done through AI, and considering whether to use those techniques on this project. For me, ‘not yet’ … but I can see it coming.

Collapse
 
momodev profile image
Santiago G. Marín

This is a fantastic read. Most of what you mention I also figured out along the way but never had the chance to put it all in an article like this one. I think I'll add it to my team's coding guidelines. Thanks for sharing!

Collapse
 
anmolbaranwal profile image
Anmol Baranwal • Edited

I think I understand your perspective; that's why I always check dependencies and other stuff when choosing a third-party library for production-level code.
It would save us trouble later on, so it's better to understand the requirements and then make the right decision.

Collapse
 
peham profile image
Peham Raza

I inherited a legacy project and was tasked to fix and maintain it, I worked on it for a few years. The project was created by several developers over the years. Once I came accross a beautiful piece of code, well documented, well written, clearly it stood out from all the garbabe I have been dealing.
I got curious I pulled git history, that code was mine, written 6 months ago.
It is worth mentioning that I have been coding from past 12 years & as you can see I could not even recognize my code from 6 months ago.
So dears, as highlighted in this article, beautiful code is easy to maintain and you are not only doing a favor to people who will be dealing with it in future but to yourself as well.
Best of luck :)

Collapse
 
skidrow406 profile image
skidrow406

great

Collapse
 
gamerman2001 profile image
Troy Gooden

Great article! Loved the quotes.

Collapse
 
tomiloba2 profile image
Omojola Tomiloba David

I find this really helpful

Collapse
 
ashleyd480 profile image
Ashley D • Edited

Upvote on the documentation! I find comments super helpful to refer back to when I'm looking at projects I did a few weeks ago to refresh memory on the what and why for my code approach. ❤️
Excellent share @technosophos!

Collapse
 
dorothyjay profile image
Dorothy_Jay

Agree with you

Collapse
 
consciousness_dev profile image
Ario Setiawan

Even no picture within it, it's easy to understand because detail explanation :O

Collapse
 
masudalimrancasual profile image
Masud Al Imran

Thank you for sharing your insight. Really helpful.

Collapse
 
yxw007 profile image
Potter

The React source code is a counter-example

Collapse
 
shubhamsigdar profile image
Shubham Sigdar

Nice article

Collapse
 
77pintu profile image
77pintu • Edited

Thanks for the great post !!!

Collapse
 
nyangweso profile image
Rodgers Nyangweso

awesome awesome content here. very helpful indeed.

Collapse
 
paulgmiller profile image
Paul Miller