← Back to the notebookKindred Hands
A working note

The work in between the tools

I was responsible for bringing the Kindred Hands software service together, with mentor support. After looking at WordPress and Dokan, the continuing costs led me towards a couple of open-source alternatives. I linked the components with guidance. I was building on existing software, rather than writing every underlying part from scratch.

That still left real work between the pieces. The e-commerce and multi-vendor responsibilities gave the setup a purpose, and useful tools did not automatically become a useful arrangement for the initiative. A component could do its own job while leaving the next step unclear. That’s why I want to explain the connections through the responsibilities they carry.

The names alone would not explain this work. The important thing is whether the same product, person or order keeps its meaning as it moves. A component may have a clear job on its own and still leave the next step uncertain. I have to follow the connection, not just assume that two useful tools automatically make a useful combination.

Consider a product path. I followed the product information through each step. Someone supplies the product details, a listing presents them, and a later request refers to that listing. At each point, I want to know whether we still mean the same product and the same supplier. The visible name may look right while the relationship behind it has become unclear. That’s why the connection matters as much as the screen.

Now imagine a detail changes. Which part is responsible for the current information? Does another part receive the change, or does someone have to act? It’s possible to choose a simple arrangement that involves a manual step. The problem would be forgetting that step exists and calling the process automatic. An honest account of the route can include people; it just has to say where they belong.

Accounts add another layer. The person managing the site may be able to see more than the person supplying one product. A helper may need to enter information without taking over decisions that belong to the supplier. Those differences are part of how the organisation works. I can’t settle them by choosing the most convenient permission for myself and assuming it will be right for everyone.

This is where the earlier planning begins to connect with the software. The order and the listing questions tell me why information needs to move. The component instructions tell me what each part expects. The integration work sits between those explanations. I need enough understanding of both sides to recognise a mismatch and know what question to ask next.

Existing open-source projects make that work possible without me writing every underlying feature. I don’t want to claim that I created the whole software stack from scratch. I also do not want to describe the work as though the pieces assembled themselves. Finding, understanding, choosing and connecting them are tasks. The fact that other people wrote useful software gives me a foundation, not a finished organisation-specific arrangement.

The guidance I received belong in that account. Help can make an unfamiliar part easier to understand, suggest a place to look or review a decision. I still have to relate that help to the setup and carry out my part of the work. The clearer I’m about the contribution of each, the easier it is to explain what I learned and what I can maintain myself.

There’s a difference between making a route work in the setup and proving every wider outcome somebody might care about. A connected system does not by itself establish payments, sales or improved livelihoods. Those require their own records and checks. I can be pleased about the integration without using it to claim results outside what the technical work shows.

A clear explanation should show where information begins, what happens to it and how somebody knows what to do next. The paths here explain that principle. They do not replace a transaction record, but they do make the responsibility of connecting the pieces easier to understand.

One way I can explain the connection work is through three kinds of agreement. The first is agreement about identity: which product or person does this information refer to? The second is agreement about meaning: does a word such as “available” describe the same thing on both sides? The third is agreement about responsibility: which part, or which person, is allowed to change the information? Those are not separate software products. They are questions I can use while following the route.

In an availability update, the first question tells me which listing is being changed. The second asks what the new state means for someone looking at it. The third asks who should make or confirm that change. If I only check that some text arrives, I could miss the other two. That’s why the work can take time even when the visible information is short.

I also have to think about the moment when a connection does not complete as expected. Does the person trying the task get enough information to know where they are? Is there a clear place to continue or ask for help? I want a clear way to return to a working setup when a change goes wrong. I can still recognise that a route is easier to use when its unfinished state is understandable.

The link to the cost decision is clearer now too. Choosing separate pieces can give the organisation more options, but it can also make some connecting work mine. That effort belongs in the story of why the alternative was suitable. If I describe only the licence difference, I leave out the very part that required me to learn and make decisions.

What makes that effort interesting is seeing several kinds of knowledge meet. I need to understand the ordinary task, enough of the software to follow the information, and enough of my own uncertainty to ask for useful help. None of those replaces the others. A technically neat connection that supports the wrong task would still leave work for the people using Kindred Hands.

When I look at the setup that way, “bringing the pieces together” becomes something I can explain in steps. It’s less mysterious than the phrase sounds, and it asks more of me than copying a list of projects. That’s the part of this journey I most want to explain clearly.

The satisfying part is that the project has become less mysterious without becoming small. There are still many details to understand, but I can see where they belong. The space between the tools is no longer just a gap in my drawing. It’s the part I have to examine closely enough that separate useful pieces can become a useful setup for Kindred Hands.

Leaving this here for next time.All the notes ↗