Hello and welcome to hlusicQA!

With a certain experience with both manual testing, automation testing, and documentation writing and maintaining, I decided to describe you my own experiences. Some of them are my advices to you, some are questions I am raising, some are just my personal opinion, and some are invitation for a constructive discussion.

Gimme Gimme Gimme more Assertions

I can’t forget the words my colleague gave me when I was just taking my first baby steps as a QA, and it was a great QA-related piece of advice: “Never assume anything.” I can assure you that the more time progresses, the more this makes sense.

Today’s IT systems we work with are more complicated than ever before, and we need to be completely sure of the outcome of any part of the system that we are either testing, exploring, or developing. If we are not sure about the expected behavior, there is always a specification or some other type of documentation that is supposed to clarify the enigma. If there is no specification and the documentation is lacking, we can always check with the project manager, product owner, developer, or anyone who is familiar with the system.

Tag Your Tests: Object/Action FTW

Sometimes the simplest additions make the biggest difference. While working on test specifications, I realized that many test cases describe what happens, but not where it happens. To fix that, I started adding a small column - or a quick tag - that turned out to be a subtle but powerful way to bring structure and instant clarity to my test documentation.

I’m the author of test specifications for a few products, one of which I’m continuously maintaining, and I’m currently designing another one for a product still in development. During both designing and maintaining, I faced a challenge that might seem trivial at first… until it starts to get on your nerves. You might find yourself in this situation too, so lean in and try to visualize it.