Arrange Act Assert

Jag Reehals thinking on things, mostly product development

What About Using Structured Naming for Event-Driven Messaging?

20 Nov 2024

It's a well-known adage that naming things is hard.

In event-driven architectures, a consistent naming convention is essential for scalability, communication, collaboration and maintainability.

At the moment, I'm architecting a new event-driven solution, and I planning to adopt a Structured Naming approach for event types.

In this post I'll share my thoughts on this approach and its benefits.

Read More →

AWS Step Functions Cookbook

01 Nov 2024

This is my AWS Step Functions Mapping and Patterns and cookbook covering data manipulation, concurrency patterns, error handling, and advanced workflows.

Read More →

Sometimes Boring is Best

26 Oct 2024

As I stood in the rain as a volunteer race marshal at my local park run, it occurred to me that I wanted the same thing when running applications in production, and that's absolutely nothing to happen.

The last thing I wanted to do was be a hero.

Me in the rain volunteering for Parkrun

🎸 "Always keep on the right side of the path" – the Parkrun version of Monty Python's song.

I'd rather everyone enjoy a safe, smooth race where I can cheer and encourage people on as they pass, reminding them to keep to the right so they don't collide with runners coming the other way.

It's the same in the land of IT. The only thing I want to see when viewing Grafana dashboards is a sea of green, 200 status codes and steady traffic patterns.

Read More →

Don't Look Back in Anger: Let's Design a Better Ticketing System

31 Aug 2024

Saturday's Oasis ticket sales left thousands of fans disheartened after spending hours in virtual queues. As reported by the BBC and echoed by fans on X (formerly Twitter) and Reddit, the experience could be aptly described using a quote from Liam Gallagher himself:

Like many others, I have long been frustrated with platforms like Ticketmaster, See Tickets, and Gigs and Tours. This weekend, their reputations took another hit as fans faced inflated prices and technical glitches.

This made me think if I could design a better, more reliable ticketing system that prioritises fairness and user experience.

Let's not make Sally wait any longer than she has to.

Read More →

The Leadership Gamble: Why Fighting for Your Team Is Essential for Success

06 Aug 2024

I've been fortunate to work with some incredible leaders throughout my career.

These individuals have inspired and challenged their teams and driven them to achieve their full potential.

What truly sets a leader apart, however, is their ability to motivate and their willingness to fight for their team.

There's something special about a leader who fights for their team.

In this post, I'll explain what happens when a leader truly stands up for their team, sharing my firsthand experiences from a transformative project at Cambridge Assessment in 2007.

A close-up image of an exam answer sheet titled 'Leadership' at the top. The sheet features a multiple-choice section with bubbles filled in. A hand is seen holding a pencil, and a bold red 'A+' grade is hand-drawn and circled in the center of the sheet. The overall setting has a realistic, academic feel, highlighting the theme of evaluation and achievement

Read More →

The Fine Line Between Frustration and Desperation

16 Jul 2024

As an England football fan, I know the feeling all too well. The heartbreak of watching your team come so close, only to fall short at the final hurdle once again. It's now 58 years of hurt.

It's a mixture of emotions – frustration, disappointment, and knowing the team could have done more.

I've experienced a similar feeling in my work as a consultant.

Harry Kane walking past the Euro 2024 trophy
Reuters
Read More →

Empathy: The Underrated Leadership Skill That Boosts Productivity

01 May 2024

As the English Football League nears the climax of another demanding season, leaders are confronted with the challenge of motivating weary players and handling the intense mental and physical pressures of chasing titles, securing promotions, or avoiding relegation.

As a Barcelona supporter, it might come as a surprise that I using Jose Mourinho, a figure often mired in controversy, who exemplified empathetic leadership during his reign at Inter Milan, leading to their historic treble win.

Mourinho and Sneijder

Read More →

Innovation Redefined: from 'Fail Fast' to 'Learn Fast'

21 Nov 2023

Inspect and adapt loops are the heart of agile development. They enable continuous learning, improvement, and evolution.

Learn Fast

In this post, I discuss the limitations of the "fail fast" approach and propose a more impactful alternative: "learn Fast". This mindset embraces the inevitability of failure in innovation and transforms every challenge into a learning opportunity.

Read More →

Structured logging with Pino

14 Nov 2023

Structured logging focuses on capturing data in a consistent and machine-readable format.

Unlike traditional text-based logs, structured logs are more straightforward to query and analyse, making extracting insights and debugging issues simpler.

Engineering coding

In this post, we'll take a look at an example of how structured logging with Pino.

Read More →

A Decade of Leadership: Celebrating Joe Parry's Legacy at the JavaScript & NodeJS Cambridge Meetup Group

10 Jul 2023

This post celebrates and thanks Joe Parry as he takes a well-deserved bow and steps down from his role as the head of the JavaScript & NodeJS Cambridge Meetup Group.

He has been an extraordinary leader who has dedicated the past ten years to fostering a vibrant community of Javascriptors in Cambridge.

Joe Parry

Photo from www.cambridgeindependent.co.uk
Read More →

Empowering Engineers: How Cambridge University Press Adopted a Shift Left Culture

08 Mar 2023

Companies must be agile and respond quickly to changing customer needs in today's fast-paced and constantly evolving technology landscape. That's why DevOps practices that emphasise collaboration and communication between development and operations teams to deliver software rapidly, reliably, and at scale have become increasingly popular.

Shifting left, a core principle of DevOps can significantly benefit companies of all sizes. By empowering engineers to take on more operations responsibilities and promoting a culture of experimentation and innovation, companies can improve collaboration, increase reliability, and deliver high-quality software at scale.

In this post, I'll discuss how and why Cambridge University Press adopted a shift left culture.

one way sign pointing left

Read More →

Pino Redaction' A Simple Solution to Secure Logging in Node.js Applications

22 Feb 2023

Pino is a popular and fast Node.js logging library that is designed for high-performance and low-overhead logging. It has many useful features, including support for structured logging, log levels, and log redaction.

Pino logging redaction allows you easily redact sensitive information logs, ensuring applications remain secure and compliant with regulations.

redacted text

Photo by Newspaper Club

In this post, we'll take a closer look at Pino logging redaction functionality, what it is, and how it can be used with examples.

Read More →

Don't repeat yourself: Why you should use child loggers in Node.js

20 Feb 2023

Logging is an essential part of any application, providing insight into the what's happening behind the scenes. However, as your codebase grows, it can be challenging to keep track of all the different log statements and where they're coming from. This is where child loggers come in.

Child loggers are a feature of many of the Node.js logging libraries such as Pino, Bunyan and winston have that allow you to create a new logger that inherits the configuration of its parent logger.

This means you can create child loggers that are pre-configured with specific options, making it easier to log messages without repeating the same configuration over and over again.

In this blog post, we'll take a look at an example of how child loggers can help cut down on repetition in TypeScript and Pino.

Read More →

Data-Driven vs Assumptions : Why Engineers Should Take a Doctor's Approach

10 Feb 2023

Engineers are responsible for designing and building complex systems that are expected to perform optimally under different conditions. However, without a deep understanding of how these systems behave, they risk making assumptions that can result in inefficiencies or even system failures.

In this post, we'll discuss why understanding a system like a doctor helping a patient is essential for engineers and by taking a proactive and data-driven approach, engineers can ensure that their systems are performing optimally and can make informed decisions that result in improved performance and reliability.

doctor talking to patient

Photo by Zach Vessels
Read More →

Why Engineers Should Try to Reproduce Production Issues Locally

23 Jan 2023

As engineers, one of our primary responsibilities is to ensure that the systems we build are stable and reliable.

However, despite our best efforts, issues and issues will inevitably arise in production environments. When this happens, it can be tempting to try and patch the problem and move on quickly.

However, recreating production issues locally is a critical step in the debugging and resolution process.

In this post, I'll explain the benefits of reproducing production issues locally.

engineering examining an engine

Photo by Aaron Huber on Unsplash
Read More →

Documentation isn't why your onboarding sucks

29 Nov 2022

Some organisations have great onboarding processes, others not so much.

Having experienced onboarding with many clients over the years, I want to share what a good onboarding process is for an engineer.

person onborading a place

Photo by Erwan Hesry on Unsplash
Read More →

Teams should communicate like a team fielding in cricket

08 Nov 2022

When working with clients, how teams communicate tells me more about the culture than anything else.

Successful teams should communicate like a team fielding in a game of cricket who work together towards the same goal giving each other support and encouragement.

By sharing information about the batters, pitch, conditions and strategy, a feilding team agree on a plan on how to bowl and position themselves.

Teams playing cricket

Read More →

Facilitation is an art

15 Jun 2022

A good facilitator seamlessly keeps the flow of conversations fluent and relevant, encouraging people to engage and have equal participation while remaining impartial and patient.

It's a role similar to a conductor orchestrating a choir.

conductor orchestrating a choir

Read More →

Creating An Animation Sequence Using Framer Motion

01 Mar 2022

Framer Motion makes creating a sequence of animations easy.

In this example, we will create a React component that animates a circle in the center of three boxes.

framer animation sequence

Read More →

How to prevent deadlock for UI tickets

18 Aug 2021

Should you build UI components and then add them to a page or build the page first then break it down into UI components is the chicken and egg of software development?

Read More →

Why great products need strong foundations

12 May 2021

You've probably heard someone quote Norm Kerths' Prime Directive during a retrospective

Regardless of what we discover, we understand and truly believe that everyone did the best job they could, given what they knew at the time, their skills and abilities, the resources available, and the situation at hand.

In my experience, engineering teams doing their best at that time inevitably end up having to shoehorn features as requirements change or new information becomes available.

In this post, I'll discuss why great products need strong foundations.

Read More →

Introducing Typescript at Cambridge University Press

22 Feb 2021

Having worked with many clients who struggled to maintain Javascript projects, Typescript was a no brainer when choosing what to use for the project I was leading.

In this post, I'll share what and how I managed the challenges of introducing and using Typescript.

Read More →

Introducing Tailwind at Cambridge University Press

22 Feb 2021

Having used Tailwind in my personal projects, I was already a convert of the utility first approach. When I was given the opportunity to lead a new project at Cambridge University Press, Tailwind was the first tool I reached for.

In this post, I'll discuss why and how using Tailwind worked out for us.

Read More →

Introducing Code-First GraphQL APIs at Cambridge University Press

22 Feb 2021

Having experienced the pain of schema-first GraphQL projects, I wanted to use a different approach for a project I led at Cambridge University Press.

In this post, I'll describe what I used and how using code-first GraphQL worked out for us.

Read More →

How To Use Tailwind Scoped Css Styles With Svelte

21 Jan 2021

In this post I'll show why and how you can use scoped styles with Tailwind and Svelte.

Read More →

How To Use Tailwind Scoped Css Styles With Next.js

21 Jan 2021

In this post I'll show why and how you can use scoped styles with Tailwind and Next.js.

Read More →

Using Tailwind? Consider adding a prefix

19 Jan 2021

Tailwind is rightly receiving all the attention it deserves. Every developer I've introduced it to falls in love with working with CSS again!

On a recent Nuxt project, I noticed a potential issue when using Tailwind class names.

Suddenly 'bg-green-500' didn't behave as expected, as an external component also using the same class had set the color to something else.

Read More →

How To Use Tailwind Scoped Css Styles With Vue

19 Jan 2021

In this post I'll show why and how you can use scoped styles with Tailwind and Vue.

Read More →

Creating Stencil Apps with Tailwind

13 Jan 2021

Stencil is a compiler for creating web components that work alone or with web applications written in React, Vue, Angular, Svelte, Ember or anything else you can think of.

Tailwind CSS deserves all praise love it's getting right now as the developer experience is incredible.

In this post I'll show how to create a Stencil web app using Tailwind CSS.

Read More →

How to fix: The request is not allowed by the user agent or the platform in the current context, possibly because the user denied permission

05 Jan 2021

It's a good thing browsers don't allow sites to autoplay audio or videos without user interaction.

However, on iOS in particular, you might encounter the error

The request is not allowed by the user agent or the platform in the current context, possibly because the user denied permission.

when there is an async operation between the user interaction and playing of audio.

The good news is there's a workaround for it.

Read More →

Getting people to believe in your vision

14 Dec 2020

It can be a struggle, endlessly trying to convince your organisation to believe in your ideas and vision.

person holding a lightbulb

In this post, I'll share how I managed to do this.

Read More →

How agile helped Cambridge Assessment to scale

07 Dec 2020

In 2008 the media were reporting on mistakes and delays in marking examination scripts. To ensure they never made the front page of newspapers for the wrong reasons, Cambridge Assessment decided to rethink how they electronically marked examination scripts for millions of students worldwide.

Read More →

Creating a product culture at Cambridge University Press

01 Dec 2020

In 2015 I was hired by Cambridge University Press to develop a web application providing digital access to over 35,000 books and 1.5 million journal articles, consolidating several smaller sites. The application would go onto have over 2 million users a day and generate £65 million in revenue per year.

It was a fantastic technical learning opportunity, but it was our culture and approach to product development that would teach me the most important lesson of all.

Read More →