← Back to the notebookKindred Hands
A working note

What one sample product can tell me

My work on Kindred Hands included smoke and regression checks, recording defects and feeding checked results back into development. Checking belonged with the e-commerce and multi-vendor work, rather than beginning only when the home page looked finished. It asked a different question from whether the software contained a promising feature.

I’m using a product in this entry to explain that distinction. The listing gives me one route to follow. One sample gives me room to follow the information and the responsibility without getting distracted by a page full of products. I can state what should happen before looking at a result: which supplier the product belongs to, what each role should be able to do and where a change should appear. Those are much clearer questions than whether the whole site looks right.

Start with the product information. A title, a photograph and a description are the obvious visible parts. The less visible question is which person the product belongs to. If I can recognise the saree in the picture but cannot explain that relationship in the software, I have only followed part of the information. That relationship matters when someone edits the listing or has to answer a question about it.

Now imagine looking at the same product from a buyer's position. The information should be understandable without the explanation that exists in the person who entered it. If a description uses a short form that only the helper knows, copying it accurately does not make it useful. The sample makes me look at the difference between preserving information and explaining it clearly.

The account used to view it matters too. An administrator may see controls a buyer should never see. A seller may need access to their product without being able to change somebody else's. I can’t decide that the whole task works just by seeing it through an account that has permission to do everything. Different views ask different questions, even when the product is the same.

In this case, the description needs a correction. Who can make it? Does it appear where the buyer reads it? If there is a review step, is the correction waiting for that step rather than missing? I want to know what behaviour the design intends before treating a delay or difference as a failure. Otherwise I could spend time fixing something that is actually waiting for a person to act.

Availability is another detail worth following. A picture remaining on the site does not tell me whether the product can still be supplied. If the person responsible changes that information, the route needs to make the change understandable to whoever uses it next. I’m not assuming a particular inventory feature here. I’m asking how our actual arrangement is meant to prevent an old page from being mistaken for a current promise.

The sample also helps separate fields that look alike. A product's displayed name and the information used to identify it do different jobs. A name can make sense to a reader while being too vague to connect records reliably. I don’t need an advanced explanation to see the problem: if two things look similar, I still have to know which one I mean when information moves between parts.

What I like about this check is that it has an expectation I can state before looking at the result. The product should belong to the intended supplier. The appropriate person should be able to change the appropriate detail. The buyer should see information that matches the agreed state. Those statements are more useful than opening the home page and deciding it looks finished.

If an actual result differs, the small example gives me somewhere to start. Did the information fail to reach the next place? Did it reach it in a different form? Is the account allowed to see it? Those are possibilities to distinguish, not fixes to apply all at once. The point is to keep enough context that the result can teach me something.

This is also where an image should earn its place in a blog. A screenshot could show the particular detail under discussion. It would still need an explanation of the account, the step and the expected result. I want the reader to know what it establishes, rather than hope the image makes a larger claim for me.

There’s one more thing I like about using a clearly labelled sample: I can make its details easy to distinguish. A title or description can be chosen so I know exactly what I expect to find next. That does not mean using a real person's information casually, and it does not turn the sample into a genuine transaction. It simply makes the route easier to follow while I’m learning how to check it.

The sample should also have a purpose. If I change its description, I’m checking the update route. If I view it through another role, I’m checking what that role can see or do. If I change several details together, I need to know which question each change is meant to answer. Otherwise the small example can become as confusing as a large set of products.

Once those expectations are clear, adding another example can be useful for a reason. It might represent a different permitted role or a different stage. More examples should add a new question, rather than simply make the test look bigger. That’s the distinction I want to keep when the setup starts to feel ready for more information.

Following one sample has made the checking feel less vague. I can see why a small example is not a small-minded approach. It gives me room to notice a relationship that might disappear inside a page full of products. The next useful step is not necessarily adding more information. It’s making sure I can explain what happened to this one piece of information all the way through.

Leaving this here for next time.All the notes ↗