All Thumbs and No Fingers

No one has ever said integration of one system with another is straight forward. But does it always need to be a surprise a minute roller coaster ride? In a recent and slightly challenging (read evolving) integration projects I devised a simple set of rules:

Action Plan:

1. Identify the unknowns
   How? Start simply with broad questions. Don’t be too quick to get into the detail as this will be the natural tendency. At this stage understand nothing about the detail but fully comprehending the end user environment or capabilities will give you a greater barometer for detecting where the unknowns are essential or not.
2. Questions everything, assume nothing
   I’ve tripped over this many times, combined with one this is probably the largest probably when scoping, initiating or specify an integration piece of work. I find Excel is my friend in this situation, I can capture questions and responses as the knowledge flows
3. Seek documentation but don’t rely on it.
   Documentation in what ever form is usually well intentioned, but out of date, inaccurate or just plain wrong. Typically the documentation will look grand ‘Technical Specification for X.Y.Z version 1.2′ however what tends to happen is that was written at the outset before a line of code had been written – ask yourself when you last went back and updated a specification at the end of project, yet you want to make key integration decisions based on it?
4. Get a setup of the system as close as possible to the real environment for use during development, verification testing and UAT
5. Commit, integrate and test regularly. Really if your not doing this forget it
6. Use real data not ‘lorem ipsum’ or ‘test account 1′
   Demand this especially if you have translation or localisation considerations to consider.
7. Allow your/encourage your client to come and inspect your work – they may see things your developer mind over looked.
   Coming from a developer mind I’m always surprised how easy it is to be lulled by our perspective on systems.
8. Testing
   Even with all the automated testing, eyeballs and code reviews I’m still amazed by how often I come across developers who see it as acceptable to ship code from their development computer to a production environment without any testing.

Have I overlooked anything you find works best for you? Let me have your comments and I’ll add them in.