Book review: Code Quality: The Open Source Perspective <i>by Diomidis Spinellis</i>

Book review: Code Quality: The Open Source Perspective by Diomidis Spinellis


Code Quality: The Open Source Perspective is aimed at the very heart and soul of the open source movement. Without code quality Open Source would be a muddied named that no one would value or deploy. This book by Diomidis Spinellis is a well written, well focused and to a high degree an eternal description of the varying types and issues that can be found in programming languages such as Java and C.

Diomidis is an associate professor at the Athens University of Economics and Business who has been working directly or indirectly with the concepts in the book since 1985. The book reeks with experience and detailed observation of the problem domain. It is obvious to me that the author has a profound insight into what makes bad software bad and thus strongly hints at how to create excellence.

The book’s coverThe book’s cover

I must admit to a positive bias, as a developer the book resonates with my core skills. I read the book with avid attention. Not a light read, the book is stuffed full of the details of the different types of coding failures. Each failure type has a real world example attached. However, the code itself is not relevant so much as the way the code fails. The code contained in this book may become old and outdated, but bad methodology has a much longer shelf life.

The contents

The ISO 9126 quality standard permeates and structures this book. Each chapter points to specific ISO related attributes: reliability, security, time performance, space performance, portability and maintainability. You are briefly introduced as a reader to the correct mindset and then thrown head first into a series of theoretical constructs. At points in the book I felt a growing buzz as I realized that I had not known specific tools existed. I found myself randomly walking in my own head as I set the new information into the context of placing standards into my own organization. The chapter on maintainability was particularly relevant. I downloaded the lachesis eclipse plugin and scanned whole projects for failures. And—guess what?—I found some, how should I say it, really interestingly elegant code.

Code quality is a consistent fight that must never be lost

Who’s this book for?

By the authors own admittance, this book is not for managers or project leaders, but rather for the code bashers among us. However, I see this book as a must have for any second year computer science student. Buffer overflows and code density are issues potential developer’s need to keep in the back of their minds while trying to reach deadlines.

Relevance to free software

The battle for the minds and hearts of users and has many entry points; cost, ease of use, reputation, quality, peer pressure. For most large scale projects such as the Apache web server, quality is absolutely not an issue. But more for the up-and-coming next generation can quality be transiently lost due to the velocity of change in the code bases. I see this one issue as a recurring factor that can in the middle term dampen the zeal to embrace Open Source. We may collectively risk a significant back lash if the balance between quality and feature richness is not found. I have observed naive deployments biased on functional requirements alone. Code quality is a consistent fight that must never be lost. This book is a summary of where the issues may lie. Therefore, this book is almost a required read.

Managers should buy the book, and not read it, but pass it on to the code bashers in their teams

Pros

Diomidis Spinellis has written a detailed roadmap of a large subset of specific programming error types. The book will have a long shelf life due to its relevance to a large audience and the longevity of the behind the scenes ideas. I personally wished I had read this seventeen years ago and recognize my own coding signature in a couple of the ISO 9126 metrics mentioned. Yep, I need to make a couple more comments here and there and perhaps a bit more unit testing!

Cons

By its very nature Code Quality: The Open Source Perspective is densely packed with concepts. This can at times make the book tiring to read. Not a book that you can or should read alone, best served by comparing with your own code bases. Managers should buy the book, and not read it, but pass it on to the code bashers in their teams.

Title Code Quality: The Open Source Perspective
Author Diomidis Spinellis
Publisher Addison-Wesley Professional
ISBN 0321166078
Year 2006
Pages 608
CD included No, Downloadable
FS Oriented 9
Over all score 9

In short

Category: 
License: 

Author information

Alan Berg's picture

Biography

Alan Berg Bsc. MSc. PGCE, has been a lead developer at the Central Computer Services at the University of Amsterdam for the last eight years. In his spare time, he writes computer articles. He has a degree, two masters and a teaching qualification. In previous incarnations, he was a technical writer, an Internet/Linux course writer, and a science teacher. He likes to get his hands dirty with the building and gluing of systems. He remains agile by playing computer games with his kids who (sadly) consistently beat him physically, mentally and morally.

You may contact him at reply.to.berg At chello.nl

Most forwarded

Interview with Dave Mohyla, of DTIDATA

Dave Mohyla is the president and founder of dtidata.com, a hard drive recovery facility based in Tampa, Florida.

TM: Where are you based? What does your company do?
DTI Data recovery is based in South Pasadena, Florida which is a suburb of Tampa. We have been here for over 10 years. We operate a bio-metrically secured class 100 clean room where we perform hard drive recovery on all types of hard disks, from laptop hard drives to multi drive RAID systems.

Anybody up to writing good directory software?

Since the very beginning, directories (of any kind) have had a very central role in the internet. (I have recently grown fond of Free Web Directory. Even Slashdot can be considered a directory: a collection of great news and invaluable user-generated comments. As far as software is concerned, doing a quick search on Google about software directories will return the free (as in freedom) software directories like Savannah, SourceForge, Freshmeat and so on, followed by shareware and freeware sites such as FileBuzz, PCWin Download Center and All Freeware (great if you're looking for shareware and freeware, but definitely less comprehensive than their free-as-in-freedom counterparts).

Interview with Mark Shuttleworth

Mark Shuttleworth is the founder of Thawte, the first Certification Authority to sell public SSL certificates. After selling Thawte to Verisign, Mark moved on to training as an astronaut in Russia and visiting space. Once he got back he founded Ubuntu, the leading GNU/Linux distribution. He agreed on releasing a quick interview to Free Software Magazine.

Is better education the key to finding better software?

I read David Jonathon's article Anybody Up To Writing Good Directory Software? the other day, which got me thinking about software directories in general. As David mentioned, many of the software directories one finds when doing a quick google search are free as in beer, not as in freedom. But what interests me is the software directories that already exist, providing a combination of both free as in beer software, and open source software. Sites such as Freeware Downloads and Shareware Download don't advertise themselves as providing free as in liberty software, but each of them have a good selection of open source software available... if you know where to look.

Most emailed

Free Open Document label templates

If you’ve ever spent hours at work doing mailings, cursed your printer for printing outside the lines on your labels, or moaned “There has got to be a better way to do this,” here’s the solution you’ve been looking for. Working smarter, not harder! Worldlabel.com, a manufacture of labels offers Open Office / Libre Office labels templates for downloading in ODF format which will save you time, effort, and (if you want) make really cool-looking labels

Creating a user-centric site in Drupal

A little while ago, while talking in the #drupal mailing list, I showed my latest creation to one of the core developers there. His reaction was "Wow, I am always surprised what people use Drupal for". His surprise is somehow justified: I did create a site for a bunch of entertainers in Perth, a company set to use Drupal to take over the world with Entertainers.Biz.

Update: since writing this article, I have updated the system so that the whole booking process happens online. I will update the article accordingly!

So, why, why do people and companies develop free software?

More and more people are discovering free software. Many people only do so after weeks, or even months, of using it. I wonder, for example, how many Firefox users actually know how free Firefox really is—many of them realise that you can get it for free, but find it hard to believe that anybody can modify it and even redistribute it legally.

When the discovery is made, the first instinct is to ask: why do they do it? Programming is hard work. Even though most (if not all) programmers are driven by their higher-than-normal IQs and their amazing passion for solving problems, it’s still hard to understand why so many of them would donate so much of their time to creating something that they can’t really show off to anybody but their colleagues or geek friends.

Sure, anybody can buy laptops, and just program. No need to get a full-on lab or spend thousands of dollars in equipment. But... is that the full story?

Fun articles

Santa Claus - the most successful open source project

It dawned on me the other day, as I was shopping for the dozens of gifts it seems I have to buy every December, that Santa Claus is the most successful open source project in history. (Bridget @ Illiterarty would agree with that). Santa Claus is essentially a marketing development that is embodied by everyone who stuffs a sock, gives a gift, hosts a dinner or wishes Merry Christmas over the holiday season.

Most emailed

Editorial

When I first started thinking about Free Software Magazine, I was feeling enthusiastic about the dream. I had Dave, Gianluca, and Alan willing to help me, I had established members of the free software community willing to help me out, I had writers volunteering their time and energy for free, and I had a generous offer from OpenHosting for servers, all before I'd proved myself. There was a sense of excitement in the air, and I thought maybe, just maybe, I could make this work.

Free Software Magazine uses Apollo project management software and CRM for its everyday activities!