perlmeditation eyepopslikeamosquito Cleaning up some old files today, I noticed some old notes I'd written on Classic Software Development Mistakes. Rather than throw them out, I thought I'd share them here. <blockquote> Adding manpower to a late software project makes it later -- <a href="http://en.wikipedia.org/wiki/Brooks's_law">Brooks' Law</a> </blockquote> This is probably the most common mistake I've seen over the years. Throwing more people at late projects seems like a reflex reaction for most managers. While Brooks reaffirmed his law in his <a href="http://www.amazon.com/Mythical-Man-Month-Software-Engineering-Anniversary/dp/0201835959">Mythical Man-Month Anniversary Edition</a> twenty years after he first proposed it, Steve McConnell <a href="http://www.stevemcconnell.com/ieeesoftware/eic08.htm">has argued</a>, unconvincingly in my view, that Brooks' Law no longer applies: <blockquote> The time that existing staff spends with new staff certainly does take productive time away from the project, and time spent training can be frustrating to existing staff members who are already feeling pressured to complete their own work. But the loss is nothing like the ratio needed for Brooks’ Law to be true. -- <a href="http://www.stevemcconnell.com/ieeesoftware/eic08.htm">Steve McConnell</a> </blockquote> While McConnell's argument sounds logical, the crucial point here is how capable and well-trained are the new staff thrown at the troubled, late project? If they are capable and familiar with the domain, fair enough. Yet in my experience, capable staff tend to already be extremely busy. Moreover, their bosses are unlikely to release them. That only leaves B-grade performers (whose bosses may be only too happy to let go for a few months) and new hires. Now, throwing untrained and mediocre developers at a troubled project has a devastating effect on morale. Existing project staff, already under extreme pressure, now find themselves spending inordinate amounts of time training and spoon-feeding their new group of <a href="http://tlb.org/telsan.html">hairdressers and telephone sanitizers</a> ... which typically leads to the better project team members resigning, the less capable ones being unable to secure a new job. Only the dead wood left behind. That is a terrible long term strategy for any company. Sadly, I'm yet to meet a high level manager who has actually read <a href="http://en.wikipedia.org/wiki/The_Mythical_Man-Month">The Mythical Man-Month</a>. Or who knew what <a href="http://en.wikipedia.org/wiki/Brooks's_law">Brooks' Law</a> is. Of course, blaming it all on Brooks' Law is an oversimplification. Often the project is not really "late" at all, but a victim of overly optimistic scheduling and poor estimation. Poor hiring and training can also cause a project to take longer than it would were a stronger team available. <blockquote> I'm not the sort of engineer that Google usually looks for. You see, I don't have a computer science degree from an elite university, or indeed any degree at all. I don't have any pretensions toward being a computer scientist, though I'm familiar with enough of the concepts and terminology to be able to work with them. I'm more the type to know and use tools -- preferably popular free and open source tools -- that other people have built, but of course Google's not very interested in that. I've also spent a lot of my time in the tech field on teaching, mentoring, encouraging software teams to adopt best practices, building relationships with other teams and with users of our software, advocating openness and transparency, and so forth, none of which Google's hiring practices care about or look for. It's all algorithm pop-quiz, and I'm crap at those. -- <a href="http://infotrope.net/2011/07/21/a-note-to-google-recruiters/">Skud Blog, A note to Google recruiters</a> </blockquote> As illustrated by the above blog, Google's infamous hiring practices are often criticized for being ridiculously onerous with an over emphasis on excelling at algorithm pop-quizzes. Certainly, Google set the hiring bar very high and must surely reject many candidates who would have turned out to be model employees if given the opportunity. Yet I agree with their overall hiring philosophy: that it is far better to reject good candidates than to hire poor ones. A common hiring mistake I've seen over the years is for a non-technical manager to hire developers without asking developers to be involved in the hiring process and without asking candidates to write any code. If you do that, it's very easy to hire developers who can hardly code at all. These sort of hiring mistakes are incredibly expensive and demoralizing because working with mediocre programmers usually frustrates the stronger developers, sometimes to the point of resignation, while sacking new hires can be a very unpleasant and traumatic experience for all concerned. Not to mention the cost (time, money and opportunity) of needing to re-hire. <blockquote> Most product managers that I have worked with would rather ship a failure on time than risk going late. -- Alan Cooper in <a href="http://www.amazon.com/Inmates-Are-Running-Asylum/dp/0672316498">The Inmates are Running the Asylum</a> </blockquote> Knowing the "right" product to build is hard, very hard. Who would have thought that twitter would be such a success? Well, it sounded like a daft idea to me. Actually, it still does. :) So product managers are an easy target. The two most common product mistakes I've seen are shipping a failure on time (as indicated by the above Cooper quote) and building the wrong product. Another more subtle strategic mistake is trying to build too many products thus spreading your resources so thinly that none of them are any good. A classic example of building the wrong product, mentioned in <a href="http://www.infoq.com/presentations/Innovation-at-Google">Patrick Copeland's innovation at Google talk</a>, was Bill Gates' unshakable belief that users wanted to see a Windows "Start" button on their mobile device. As you might expect, most Microsoft employees were reluctant to challenge the company founder on what product to build. Maybe <a href="http://www.pretotyping.org/">pretotyping</a> would have helped here. I could rabbit on and on, but that's enough from me. I'd love to hear about the software mistakes you've seen. To help jog your memory, I list below a summary from McConnell's <a href="http://www.stevemcconnell.com/rdenum.htm">Classic Mistakes Enumerated</a>. People-related mistakes <ol> <li> Undermined motivation. <li> Weak personnel. <li> Uncontrolled problem employees. <li> Heroics. <li> Adding people to a late project. <li> Noisy, crowded offices. <li> Friction between developers and customers. <li> Unrealistic expectations. <li> Lack of effective project sponsorship. <li> Lack of stakeholder buy-in. <li> Lack of user input. <li> Politics placed over substance. <li> Wishful thinking. </ol> Process-related mistakes <ol> <li> Overly optimistic schedules. <li> Insufficient risk management. <li> Contractor failure. <li> Insufficient planning. <li> Abandonment of planning under pressure. <li> Wasted time during the fuzzy front end. <li> Shortchanged upstream activities. <li> Inadequate design. <li> Shortchanged quality assurance. <li> Insufficient management controls. <li> Premature or too frequent convergence. <li> Omitting necessary tasks from estimates. <li> Planning to catch up later. <li> Code-like-hell programming. </ol> Product-related mistakes <ol> <li> Requirements gold-plating. <li> Feature creep. <li> Developer gold-plating. <li> Push me, pull me negotiation. <li> Research-oriented development. </ol> Technology-related mistakes <ol> <li> Silver bullet syndrome. <li> Overestimated savings from new tools or methods. <li> Switching tools in the middle of a project. <li> Lack of automated source-code control. </ol> Perl Monks References <ul> <li> [id://116380] (2001) <li> [id://416865] (2004) <li> [id://442597] (2005) <li> [id://728569] (2008) <li> <a href="http://tinita.de/docs/slides/don_t/slides.vroom">Don't slides</a> by [tinita] <li> [id://486805] </ul> References <ul> <li> <a href="http://www.stevemcconnell.com/rdenum.htm">Classic Mistakes Enumerated</a> by Steve McConnell <li> <a href="http://www.stevemcconnell.com/rdmistak.htm">A Case Study in Classic Mistakes</a> by Steve McConnell <li> <a href="http://blogs.construx.com/blogs/stevemcc/archive/2007/06/15/Classic-Mistakes-Updated.aspx">Construx Classic Mistakes 2008 (Blog/Survey)</a> <li> <a href="http://www.construx.com/Page.aspx?cid=2537">Construx Classic Mistakes 2008 (Results/pdf)</a> <li> <a href="http://www.joelonsoftware.com/articles/fog0000000069.html">Things you should never do (rewriting)</a> by Joel Spolsky <li> <a href="http://discuss.joelonsoftware.com/default.asp?joel.3.744487.27">Joel Discussion of Classic Software Mistakes (closed)</a> <li> <a href="http://mindprod.com/jgloss/unmain.html">How to write unmaintainable code</a> by Roedy Green <li> <a href="http://www.exampler.com/testing-com/writings/classic/mistakes.html">Classic Testing Mistakes</a> by Brian Marick <li> <a href="http://en.wikipedia.org/wiki/The_Mythical_Man-Month">The Mythical Man-Month</a> <li> <a href="http://en.wikipedia.org/wiki/Brooks's_law">Brooks' Law</a> <li> <a href="http://www.stevemcconnell.com/ieeesoftware/eic08.htm">Brooks' Law Repealed?</a> by Steve McConnell <li> <a href="http://www.linuxtoday.com/infrastructure/2000060600706NWCY">Brooks' Law and Open Source: The more the merrier?</a> <li> <a href="http://portal.acm.org/citation.cfm?id=1367924">Brooks' versus Linus' law: an empirical test of open source projects</a> </ul>