Maintainability: One Story and Three Concerns
Published on January 31, 2012 (⻠February 5, 2024), filed under Development (RSS feed for all categories).
This and many other posts are also available as a pretty, well-behaved ebook: On Web Development.
To make this a little story, for a long time in my career I wasnât very concerned about maintainability.
I was maintaining projects but didnât have an idea about whether what I maintained was actually effective to maintain. I got a sense that things werenât quite right and that I was spending too much time on maintenance, but that didnât lead me anywhere.
At some point I noticed that there were a few things that made projects easier to maintain, and that there were other things you simply never want to deal with.
Then I got the suspicion that hardly any web developer or designer had ever done a CSS-only redesign. I still have this suspicion today. There are reasons why a redesign cannot just be done by updating style sheets, primarily due to content and hence structural changes. But more often than not it would be possible, if maintainability was a priority and something that developers would be taught, to just update style sheets. (The small number of CSS-only redesigns may well be seen as an embarrassment for our industry.)
When looking at other sites more closely I noticed that more things were happening that shouldnât be happening at all, contributing to never even getting close to something like a CSS redesign.
As there wasnât much useful information out there on how to make websites more maintainableâclearly not helping the situation at handâ, I then compiled a guide on maintainability, promoted what appeared to be useful in order to write more maintainable code, and created tools to identify maintainability issues.
Now, since there is a general understanding of why good maintainability is important Iâve been wondering about other causes for the problems we can observe:
-
The prevalent mindset appears to be close to âfire and forgetâ as people oftentimes donât appear to care whether, how, and who is going to work on everything in a few days, months, or years.
-
Especially developers seem to overestimate the power of technology when all too eagerly referring to that âthis is not a problem because weâd only change a template.â (Maintenance is never âjust changing a template,â and unnecessary changes are unnecessary changes.)
-
Developers may have gotten into the habit of preferring âconstruction kits,â overlooking or dismissing the power of tailored solutions, and they appear to forget about the craft of web development.
Consequentially, our industry, in well some shortsightedness, appears to be wasting hours and dollars by not paying attention to maintainability. Based on my observations and estimates, the lack of attention makes any rather complex web project about 50% more expensive over the first one or two design and code iterations alone.
Inadvertently Iâve just alluded to another reason for the whole drama, beside lack of documentation and education: There is no data documenting the cost of our industryâs current practices. Youâd need to test against the âideal worldâ which we know doesnât exist but in our heads.
The point is this: Focus on maintainability. It may easily be the biggest untapped cost saver there is for our industry.
About Me
Iâm Jens (long: Jens Oliver Meiert), and Iâm a frontend engineering leader and tech author/publisher. Iâve worked as a technical lead for companies like Google and as an engineering manager for companies like Miro, Iâm a contributor to several web standards, and I write and review books for OâReilly and Frontend Dogma.
I love trying things, not only in web development (and engineering management), but also in other areas like philosophy. Here on meiert.com I share some of my experiences and views. (Be critical, interpret charitably, and give feedback.)
Comments (Closed)
-
On February 3, 2012, 12:57 CET, Vivien Blasquez said:
Great article ! I totally agree with you when you said âdevelopers may have gotten into the habit of preferring construction kitsâ. We see more and more today.
-
On February 14, 2012, 18:34 CET, Ty Cahill said:
Another problem is all the âhacksâ out there building websites. I talk with many small business owners who have been sold Yahoo and GoDaddy websites by âweb designers.â Knowing how to use a computer does not mean you know how to design and build a website. And clicking through a wizard-based website builder does not make you a web designer. I can change the oil in my car, but Iâm not a mechanic.
All the hacks out there do a huge disservice to the web design and development industry. And I really like how you bring up the âcraftâ of web development. It is a craft, yet most people gloss over the skill necessary because they own one of the tools (computer), and therefore they should be able create something just as good as those skilled and trained in the craft.
Okay, time for me to stop rambling. Good article, by the way. đ
Read More
Maybe of interest to you, too:
- Next: HTML and Non-Script Styling
- Previous: âwindow.scrollTo()â or: When to Stay Clear of User Agents
- More under Development
- More from 2012
- Most popular posts
Looking for a way to comment? Comments have been disabled, unfortunately.
Get a good look at web development? Try WebGlossary.infoâand The Web Development Glossary 3K. With explanations and definitions for thousands of terms of web development, web design, and related fields, building on Wikipedia as well as MDN Web Docs. Available at Apple Books, Kobo, Google Play Books, and Leanpub.