• Whatever methodology you use, aim for the best of flat, self-organizing teams. Make sure to mind the inter-team gaps. That’s where architecture helps.
• My team could probably use UML more for modeling the architecture (the “what” and “how” of interactions between our features) more. Color-coding different class/component roles adds another dimension of description.
• Do class-responsibility-collaboration (CRC) modeling for architecture. Using Post-Its makes it “Agile.”
• “Coding the Architecture” = Win. “Project Managing the Architecture” = Fail.
• Focus on functional/nonfunctional requirements, constraints, and operating principles.
• Use “paper prototype”-like activities in small groups to create effective sketches of the architecture. Then ask “Would you code it that way?” If the answer is no, redo/fix it.
• The architecture should highlight both the domain (e.g., accounting) and software design (e.g., GUIs, model-view-control, etc.).
• Base the architecture on requirements and prove the architecture works via experiments.
• Architecture is what is difficult to refactor in an afternoon (or week). It’s costly to change, complex, risky, and (often) novel.
• Do “just enough” design. How do the significant elements work together, mitigate key risks, provide foundation to move forward.
• Just document what the code doesn’t describe.
• We need our technical mentors to keep teaching as they keep moving up the corporate ladder.

Dear Diabetes Blog Week readers, we’ll be back to our normal programming tomorrow. Stick around. (I don’t post techie stuff like this very often.)

• When optimizing code for GPU, FPGA, or CPU, definitely focus on pipelining and overall throughput, not just local optimizations.
• There’s a trade-off between “faster” and “sooner.” It’s not always worth saving a few seconds (or even a few minutes) if the kernels take hours or days to compile. (Then again, sometimes it is.)
• Try to reduce dependence on the language/compiler “stack” that removes inefficiencies. The optimizer does good work, but you can do things to help it. Think about the hardware or architecture format. It’s not a sin to reduce the amount of abstraction in the service of performance. Pay attention to things that affect processor pipelining and cache movement.
• BTW, some languages and technologies exist to provide higher level programming that’s close to the hardware, but they’re proprietary, secret, or still in R&D.
• Use algorithmic optimization techniques. Step back and find the shortest-time computation.
• Avoid using if statements. The goto construct is considered harmful, but if is basically the same thing. Instead think about state machines and polymorphism. There’s no branch-prediction penalty to pay, since the system “just is” in the state it’s supposed to be in. The logic is clearer, because there are no switches, making it easier to test, too.
• Don’t always assume that floating-point values are necessary. Integers can often be creatively used and are far faster for math than double-precision numbers.
• Of course, there’s a compromise between speedy/efficient and readable/maintainable.
• Aim to structure programs as “symbolic intent.” Mathematical descriptions are bad ways of expressing programs. Think about functional programming models instead of procedural.

If you want to know more, you should definitely watch the half-hour interview. And if your reaction was more along the lines of “Yes, yes; that’s all true, and it’s how I design my image processing code,” then I definitely hope you’ll consider applying for the GPU/multicore engineering position we have open.

This is another one of those posts. Every year between Christmas and New Years Day, I try to use the quiet week to get stuff done and tie up loose ends. Last year, I cleared out a bunch of notes. This year, I’m looking at presentations and slides from the QCon SF 2011 conference (wrap-up). Its focus on software architecture and project management is about 75% of my job, so many of the presentations seemed tailor-made for me. Here’s some of what I learned.

Erik Doernenburg. “Software Quality: You Know It When You See It” has a really good slide deck that got me thinking about some projects I might want to set up. It’s full of practical, usable suggestions:

• View the code at the 1,000 view, rather than ground-level or 30,000 feet.
• Look at the test-to-code ratio, not just code coverage.
• Graph the change of metrics between versions and revisions, compare across different parts of the code, and look at them relative to industry standards.
• Measure the “toxicity” of code by rolling up various quality metrics about a bunch of modules into stacked bar charts.

We should pose these questions during design and code reviews:

• Is the software/change of value to its users?
• How appropriate is the design?
• How easy is the code/design to understand and extend?
• How maintainable is the software?

It was full of some really great links to things like Metrics tree maps (a.k.a., pretty heatmaps for source code) as well as a few tools: SourceMonitor, iPlasma, and using Moose to visualize quality.

Joshua Kerievsky. “Refactoring to Patterns” — some notes:

• Refactoring is like algebra’s equivalence-preserving manipulations. “Design patterns are the word problems of the programming world; refactoring is its algebra.”
• Understanding the refactoring thought process is more important than remembering individual techniques or tool support.
• Code smells have multiple refactoring options and often benefit from composite refactorings.
• Look for automatable refactorings first. Consider changing the client of smelly code before the smelly code itself.

Guilherme Silveira. “How To Stop Writing Next Year’s Unsustainable Piece Of Code” was pithy and thought-provoking.

• There is no value for architecture or design without implementation. That’s just interpretation of the software.
• “New language. New mindset. new idiomatic usage. Same mistakes.”
• Complexity and composition are natural and good, but if they’re invisible, they’re evil.
• Start with a mess and refactor right away. Starting “right” is hard (and misguided thinking). Refactor for better, not just prettier.
• Make complexity easier to understand and see.
• Hiding complexity in concision hurts testability, since no one knows the complexity is there. Furthermore, if it’s hard to test, it’s also hard to use correctly.
• “Model rules. Do not model models.”

Michael Feathers. “Software Naturalism: Embracing The Real Behind The Ideal” is a presentation that I would like to see/hear, since the slides seemed full of information but weren’t self-explanatory. Here are two things I could glean: 80% of software defects in large projects were in 20% of the files. In general, the more churn in a file, the more complex it tends to be.

Panel: “Objects on Trial” was perhaps the most unusual presentation, since it was a mock-trial. I use objects all the time . . . some of them are good . . . some demonstrably so. Even so, I never latched onto the idea of object-oriented (OO) design versus objects as types. The four panelists, in one way or another, basically said, “That’s the problem.”

One of the panelists drew an extended analogy between the space program and OO. The space shuttle (which we all love) was fixated on reuse but basically was a waste of heavy lifting; people don’t reuse the right stuff. In software, object reuse is largely accomplished by cut-and-paste copying of boilerplate code that does close to what you want. Of course, the panelist acknowledged that we do reuse the ideas in OO via design patterns, and no one seems to have much of a problem with that. Ironically, having a rich pattern language means that software engineers are in a better place than ever before to use objects correctly.

A key problem with our approach to objects is that we’ve failed (generally in software engineering) to handle complexity well, which was supposed to be the point of OO design. A conflation of beauty and OO design makes things worse. Internally, software is ugly, and beauty shouldn’t be a goal. Making a fetish of beauty makes code inflexible because people don’t want to extend the beautiful thing that works.

For other panelists, objects weren’t the problem at all. For them it’s static typing in “OO languages,” such as C++, Java, and C#. We’re at a place now where all of the good things about OO have been lost in an attempt to make OO languages as fast as C. This runs counter to the goal of having “ordinary,” understandable code. Generic programming using strongly typed (possibly template heavy) languages just makes everything complicated.

For me, it’s moot. C++ is what I use, and I don’t have a large proprietary object system that I can tap into for reuse. I’m in the camp that uses C++ objects to generate new types for data hiding and aggregation, as well as (to a lesser extent) reuse. But some of these types are generic, template classes that are hard to understand. I plead “no contest.”

So, into Microsoft Excel it went. After sorting and grouping the data, here it is:

Diabetes Exercise Data

Believe it or not, I am really more of a narrative person than a numbers person, and I already worry that looking at the data this way will obscure other important details or magnify the importance of data over context. (That’s actually why I hate the way many endocrinologists approach diabetes management, though I understand why they do it that way.) Nevertheless, I hope this different view into the last five weeks will illuminate trends. We shall see what comes from all of this.

• Lisa and I took a day-trip to New York to see an exhibit on insulin and meet people with diabetes from the online community.
• I visited the MFA several times since the new Art of the Americas wing opened.
• I traveled to San Francisco to attend a couple of conferences.
• We went to the Museum of Russian Icons in Clinton.
• And, of course, there was a lot training for a half-marathon in March and a triathlon in a few weeks.

Here are photographs from our five-month winter adventure.

Ενα “whiskey” σε παρακηλω!

Le soleil sûr ma tête, ce me fait comme un bête.

ΑΡΧΕ ΚΟΡΙΝΘΩΣ

La pluie de l’Espagne reste pour le plus part dans les pas.

शान्ति ॐ शान्ति

οίμοι κακαδαιμων εγένετω τυφλός

Je veux crasser arracher mes yeux.

Compiled apps don’t run
In R2009b.
Missing DLLs.
— A haiku

Mon petit chat a des cheveux blancs et noirs.

ή γύνη σπεύδει προς των αγρών

I’m pleased to say that it looks like I might get a chance to follow-up on that idea more in the coming year. I’ll keep you updated. In the meantime, here are few ideas on the subject from one of my notebooks. (I appear to be going through these “historical documents” in a rather random chronological order.)

When are the pause points where we might use checklists?

• Before starting to design
• Before starting to code
• Before code review
• Before submitting changed files
• Before QE-led testing

Who might be included in the check-off activities? The goal is to catch problems and communicate what’s happening.

• Coder/Developer
• Quality Engineer/Tester
• Buildmasters
• Doc Writer
• Project Leader (?)

What’s so mindless that it’s taken for granted? (e.g., “build and run tests on every platform.”) Are these second nature? Or are they sometimes forgotten/overlooked/not done?

What goes onto a “pre-flight” checklist? What goes onto special circumstance (“OMG the plane is crashing!”) checklists? The idea is to have lots of small checklists.

What level of specificity is required for a checklist?

Today, requirements. I honestly can’t remember if I’ve written here about defining requirements in software projects. Getting them defined right is so important, I would be surprised if I hadn’t. Here are just a few more notes.

Questions to ask about your requirments:

• Are they adequately motivated?
• Are any missing?
• Are there any included that aren’t really needed?
• Are any solutions masquerading as requirements?
• Are they testable?

These requirements are often overlooked:

• Localization (L10N)
• Robustness
• Performance (speed, memory)
• Backward compatibility

And remember, not all requirements have the same priority. Try to stage solutions to address different priority levels.

Update: It’s hilarious how many times I’ve already found names and telephone numbers for people who work at Medtronic Minimed.

• tort — pas correct
• retraite — pension
• parmi — among (“parmi ceux-ci . . .” = “among these . . .”)
• la Toile — The Web/Internetz/etc.
• mention — statement (masc. n.)
• pouce — thumb
• renverser — to overthrow
• pari — gamble (masc. n.)
• pas forcement — not necessarily
• nulle part — nowhere
• ailleurs — elsewhere
• hors piste — backcountry
• bourrée — stuffed
• enregistrer — to save
• majordome — butler
• à la une — feature (as in “a featured story”)
• tyrolienne — yodel (fem. n.)
• se faire chier — to piss off, to annoy, to have a fucking nightmare, to be pissed off
• la chiasse — the shits
• chiant — boring
• piéger — to trap, ensnare (“la France piégée par les vélos”)
• les hirondelles — the swallows (birds)
• locataire — tenant (fem.)
• ado — teenager, adolescent
• tache — stain (fem. n.)
• honte — shame
• crainte — fear
• les orteils — toes
• marée noire — oil slick
• tricheur — cheater (masc.)
• hauban — linceul, shroud
• paroisse — parish
• tiroir — drawer (as in “a desk drawer”)

• bagnole — voiture (a car)
• virée — petit rendre-visite (a small trip, a hike, etc.)
• revendiquer — to claim
• raté — failed, attempted, missed, abortive (adj./pp.) or failure, misfire, backfire (n.)
• portiques — gates, turnstiles
• rien que… — just…
• jeu de mot — pun
• étonnant — amazing, enormous
• touche — un clef sur le clavier de l’ordinateur (keybord key)