Collaboration 🤝

Owned by Kim Dang (Unlicensed)
Last updated: Jun 09, 2021 by Franziska Hempel
2 min read

Code-review 🔬

All code needs to be reviewed by a second engineer before being merged into master. 

We don’t have hard and fast rules on how we do code reviews. For more complex tickets it might make sense to do a walk-through, where the author explains his solution to the reviewer. For less complex tickets it might be easier for the reviewer to do the review by himself. It’s up to you to decide what feels appropriate for the given PR.

Some points to make Code Reviews run smooth:

  • Keep issues in separate branches for easier separation of changes in the review

  • Do reviews between issues ie. do reviews before starting on the next issue

  • Always find the reviewer immediately when finishing up the issue and schedule a time slot if the review needs explaining

  • Add a comment to the issue with implementation overview, what should work and what old functionality is in the risk or breaking ie. what is affected by the new changes, a link to the ticket is enough if everything the reviewer needs to know can be found in there.

  • Merge master to feature branch and run tests before review

Rubber Ducking 🦆

The concept behind rubber ducking or rubber duck debugging is simple yet effective: by explaining your code or a problem you’re trying to solve to someone else or even an inanimate object (like a rubber duck), you gain a deeper understanding of the problem and might even hit upon the solution in the process of explaining.

While this is mostly used for debugging, we encourage you to also use this technique before starting to implement a complex task or when you are stuck in between.

Please try solving the issue on your own first (we are happy to provide you with a rubber duck), before consulting someone else but don’t be afraid to interrupt another engineer if you need help. Find someone and explain what you’re trying to solve and how you think you want to approach it and you might even get a second opinion or a pair programming session out of it.

Pair-programming

Writing Code in pairs or even doing the occasional mob programming session is not a mandatory part of our workflow, but highly encouraged. Especially during your onboarding phase or when you take over a new project, your peers will be happy to pair with you. But also after the first few months, if you enjoy this style of working and all the advantages that come with it, from sharing knowledge to getting your code review “on the go“, check with your peers during planning and grooming sessions which stories you want to pair on.

Some Best Practices for your Pair Programming Sessions:

  • Check Tools Like CodeTogether to collaborate remotely directly within your IDE

  • Switch Driver and Navigator Roles often to keep focus and engagement

  • When you are the driver, talk through what you’re doing as you are doing it

  • When you are the navigator, give directions on the bigger picture and share your thoughts but avoid micromanaging the driver

  • Keep your pair programming sessions to a few hours max, pairing for the entire day can get quite exhausting and doesn’t yield the best results