Manual testing is useful, but not often

Let's not beat it to death, because it has its moments too. Spare some pity for the poor sod.

No, you don't have to brood on this question. There are some valid reasons to sometimes do these things manually. I'll try to address some parts which are totally fine to do manually without being contradictive to our end goal of automating tests.

The first time you do something

In general, automating anything is something you do for the long term. Therefore it's not uncommon that when experimenting, designing, and trialing ideas, then you do this manually. At this stage, the code is not ready to be tested because that's not where you are in the lifecycle of whatever you are building.

Collecting initial test data

Inevitably you will need to have some amount of data available. If you are building a new service and expect it to integrate with some third-party system then you'll progress roughly through a sequence such as:

  • Design a solution, or make a hypothesis

  • Find out which APIs to integrate with

  • Ensure they are documented

  • Find out what the expected inputs and outputs look like (i.e. data)

  • Verify "toy" functionality, using the API for real (see the next point)

  • Collect the test data (inputs, outputs)

Storing the data in your code base means you now have superpowers, making it possible to:

  • Write the integration

  • Mock the integration so you don't have to use the real deal during tests etc.

  • Write the tests of the integration

Yes, it's a chore to get that data but that's nothing to have feelings about, given you win a lot for that tiny investment of manual effort.

Basic checks and verifications

During development, it's convenient and entirely realistic to have an Insomnia design document or Postman request collection with your endpoints and typical calls, ready to use at the click of a finger. So, there, I wrote it: Manual checks and verification are OK to some extent when it carries a meaningful impact.

Handle this like a troubleshooting tool rather than as anything else. Whenever the case is something that you systematically have to do, it's time to look into automating whatever it is you are doing.

Exploratory testing

Exploratory testing can be an interesting approach, but should not be done in an unqualified way or on unqualified work. If a system is strictly deterministic and you've written at least basic safeguards and checks, as well as using a module structure in which there are clear flows that cannot be misinterpreted or abused, then the need for exploratory testing rapidly diminishes.

Exploratory testing, at least for me, seems to be most useful when we truly know nothing (or very little) about the thing we are testing. For most engineers, this should never be the case; rather think of this as sending in a minesweeper to an uncharted war zone to understand what nasty surprises we are facing.

Exploratory testing might also be a ruse

I am opining this in a totally self-aware snarky tone.

Your number 1 goal is to write deterministic code. Without it, anything could happen! There is no meaningful test that can be written for such situations.

Exploratory testing is a well-meaning test strategy that has started to gain traction.

Exploratory testing is an approach to software testing that is often described as simultaneous learning, test design, and execution. It focuses on discovery and relies on the guidance of the individual tester to uncover defects that are not easily covered in the scope of other tests.

โ€” Atlassian

It aims to leverage qualified manual labor to "explore" what a system can do, which to me at least is about trying to find holes in it. To me, it sounds like a strategy not dissimilar from the work done by a penetration tester whose aim is to uncover vulnerabilities in a system. The exploratory tester, however, will have a broader mindset.

One of the more influential names in this area is Maaret Pyhรคjรคrvi. Check her videos, texts, or social media if you are curious.

Don't get me wrong now, but part of your unspoken job as a software engineer is to not have testers around. Just don't tell them that! Following agile principles and practices, there would literally exist no testers. See for example Kent Beck's old rules of Extreme Programming (which is a sister/brother to most of the other Agile you may know):

All code must have unit tests.

All code must pass all unit tests before it can be released.

When a bug is found tests are created.

Acceptance tests are run often and the score is published.

I'm sure you'll already be well aware that old grumpy Uncle Bob will also have written several books on this. Even a corporate moderate like Dan Radigan at Atlassian goes as far as stating that "let's be clear: scripted manual testing is technical debt." There is no manual option. It's that easy.

So if your number 1 goal is to write deterministic systems, then being "explorative" may very well be meaningful, either in:

  • Very ill-performing systems.

  • Unknown or undocumented systems.

  • Very large (probably undocumented) systems.

To the extent that we need manual testing, I feel entirely confident in writing that such a role should come with abilities include coaching, enabling, being transformative, and being only transitive (disappearing after some short time)โ€”i.e. more along the lines of quality engineer, quality coach, or similar notions. Atlassian also comments on this limited scope:

An exploratory testing session should not exceed two hours and should have a clear scope to help testers focus on a specific area of the software. Once all testers have been briefed, various actions should be used to check how the system behaves.

โ€”ย Atlassian

In summary, exploratory testing sounds like something that makes a lot of sense when we want "bang for the buck", being expensive, laborious, and qualitative in its delivery. We can't rely on it for our continuous work.

In closing

While this is in no way an authoritative account of all cases where manual testing makes sense, they should summarize some clear directions:

  • Manual testing is unavoidable in many cases while you are writing the first bits with integrations.

  • We need to uncover unknown parts of unknown, undocumented systems.

  • As one part of our development work ("pushing-and-prodding").

Last updated