When I started to pair programm I had absolutely no idea what I was doing. I sat next to another programmer and we started. Sometimes it worked but more often it was frustrating.

Maybe you are new to pair programming and want to give it a try, or you have trouble getting started. Then this blog post is for you.

I show you how we pair at Gutefrage.net. Some of this advice is really obvious - but much of the other stuff we figured out the hard way through pairing over and over again.

Thinking together
"Lightspring/Shutterstock.com"

Preparations for your first pairing session

Probably your workspace is not prepared for 2 people working on it for an extended amount of time. So before you even begin: Be a good host: *Adjust your environment for pairing. *

Physical preparation of your workspace

Move away the piles of paper, the dishes and your backpack under the table. Clean your table. Don't let the navigator feel like he is just visitor.

Now move 2 chairs in front of the table. If you do not pair all the time it is also ok to keep a few spare chairs scattered through the office.

Prepare your hardware

Now take a good look at your screen(s). Can you see them from both perspectives? Is the contrast high enough?

Especially with notebook screens it can happen that the person sitting next to you will have such a bad contrast that it might be hard for your pair to see what you are doing. If this is the case get a monitor that both of you can watch.

Place a second mouse/keyboard combo on your desk. It's nice for the navigator to point to code or be able to write a chunk of pseudocode and it costs nearly nothing.

Prepare your computer

Adjust your font size to 16px or 18px. I know this seems ridicullisly big but it will be much nicer for the navigator to look at it. (And also for you of course)

Now close all your programms. E-Mail clients, IRC, Instant Messenger are a no-no during pairing in my opinion. You will have time for checking this stuff in between the pairing session.

Prepare an editor/IDE that both of you can use. Get an environment ready that works, check out the project, run the tests.

Talk to your partner

You should know each others schedule. I find it frustraiting if my pair has to leave in 15 minutes. Better to know in advance.

Grab Essential tools

Now the navigator should grab a notepad and a pencil. Also prepare a timer.

A kitchen timer works fine, alternatively search for "Pomodoro Timer" on Google.

Immediately before every session

Grab a coffee, go to the restroom and prepare yourself to focus for the next 25 minutes. Close open loops that might distract you during this time.

The first pairing session

At the beginning of each session the navigator sets the timer to 25 minutes.

Then talk about what you want to do on a high level. Both of you should have a good idea about the scope of the task ahead and what steps are involved.

If the taks contains of multiple steps the navigator should write down a list off these steps.

Write a test first

Pick the best step to start with and write the first test. Try to get the test right, so you both understand what needs to be done.

TDD is especially effective in combination with pairing, it communicates what you want to do and it will focus both of you on the next step.

Driver

Now the drivers your responsibility is to implement the code. Explain what you are doing along the way. Do not concentrate that much on the big picture, but try to get the task at hand done. Trust your navigator to keep the larger picture in sight.

Whenever there are alternatives ways to do it and you are not sure - ask your navigator what to do.

Let the navigator guide you through the list of tasks. Ask him how to proceed if you are unsure.

Ensure that you work on the tasks on the list.

If you discover additional tasks - it often does make sense to postpone them and focus back on the problem at hand. It's your responibility that both of you don't forget them - so note them down.

Keep engaged with the driver and try to understand what the driver does.

When you notice that the Driver get's stuck unstuck him. Even if you don't know the answer to the problem at hand - ask him a question.

Point out typos or problems if the driver does not see them himself. Is the code understandable? Are the variable names ok? Is the class getting to bloated? Do a on the fly code review. Mention problems. But do not micromanage of course. - Just like in a normal code review.

Pull the driver out of the implementation if you have the feeling that you should change the angle. Discuss it with him.

Talk, talk, talk!

Talk, talk, talk!
"pio3/shutterstock.com"

You should communicate all the time! In a good pairing session it really feels like you are working on this in unison. As the driver you can focus on getting the tests past and as the navigator you can keep the pair going in the right direction, ensuring an excellent quality.

Communicating right is maybe the hardest part for most programmers - just keep doing it. It's a skill that you can aquire and if the pair is really attuned to each other after many session this will feel like second nature to you.

General behavior

Concentrate at the task at hand for 25 minutes. Do not watch your emails, do not take breaks, try to stay engaged. It is really expensive for 2 programmers to become distracted.

Work step by step from your list. After you have finished a step take it off the list and start working on the next step.

Don't argue to much. This is not an ego game - if both of your solutions are equivalent just decide and keep going 😉

After the session

The session ends after 25 minutes. Take a break of at least 5 minutes. This is the time to grab a coffee, to visit the toilet, check your mails and take a break.

Good pairing is intensive. You will need the break especially if you want to work for a few hours in a pair.

After each pairing session switch roles. We solve this with a WIP commit to the feature branch, then we change workstations.

After the your break is over start another pairing session if needed.

Conclusion

Getting started with pairing is no easy feat. Don't get discurraged. It is worth to learn it.

In a future blog post I will describe the many many problems that you might encounter during pairing and how to tackle them.

I hope after reading this little primer you get the idea how this could work and be sustainable. Since this are not best practices by any means, feel free to implement pairing your own way.

If you have experience pairing or tried this out: What are your thoughts about this? How do you pair?