Tell HN: Thing I learned this year was keeping a work journal

11•Muromec•6mo ago

I once saw a comment suggesting to keep a working journal here and I want to say it's the best thing since figuring out how and why to write unit tests.

Whenever I have to do something that involves more than one line in more than one file, I make another text file, called JOURNAL in the root of the project and write down all the things I plan to get back to.

All the side quests spawned from fixing that one bug, all the slightly obscure parts that I need to figure out what they were doing, all the missing unit tests. And then I don't publish the PR until all of them are either ticked off or transferred to whatever JIRA-hell I have.

I unlocks two capabilities -- 1) I can just close my laptop at any time and whenever I get back I still remember all the half-done, to be checked later, doesnt-break-the-build-but-is-obviously-wrong things. and 2) I can open two probjects each with it's own JOURNAL and switch between them without pain.

Keeping the write ahead log to recover from memory loss isn't only for filesystems, it's for minds too. Shocker.

Comments

Room10Mind•6mo ago

You’re 100% correct. Everyone must keep a work journal. At least emailing themselves everyday to keep track of things. Hugely helpful when you want to reflect on your progress, and decide if the company you’re in right now gives you the opportunity to grow the way you want.

treetalker•6mo ago

In so doing, consider asking yourself how others will read it in the event it gets subpoenaed. (Not legal advice, just food for thought.)

Muromec•6mo ago

That's an interesting perspective. I don't put there anything that I would not put into git commit message. For it to be subpoenaed somebody needs to know I have, right?

treetalker•6mo ago

I'll leave it at this: the point of discovery in litigation is, first, to find out what the other side (or their current or former employees, or third parties) has that might be relevant to the lawsuit; and, second, to obtain it.

codingdave•6mo ago

I used to go for walks at lunch with a friend who was an attorney. He lived his whole life in the habit of considering the legal risk of everything. He told me that I trusted people more than he did, would probably get hurt by it more than he will, and probably am a happier person and more satisfied with my life because of it.

treetalker•6mo ago

This is almost certainly the case. Law practice probably deserves the title of the "dismal science" more than economics does — both as dismal, and as a science. Still, after practicing for a while (perhaps even just during law school) it becomes simply a perception of life that is closer to base reality than one had before — probably similar to a physician's view of the body and biological processes after encountering so much disease, decline, and death, as well as the methods by which those might be prevented, eased, and forestalled.

EDIT: I'll add that I, too, maintain a work journal. The nice thing is that mine can't be obtained through discovery in most situations because of attorney–client privilege, attorney work-product privilege, etc. The lousy thing is that I'll never be able to share complete details of my lessons with most others (save, e.g., other lawyers in my law firm) because of the duty of confidentiality, etc.

Muromec•6mo ago

Oh, I totally get it. I had once read an executive order with an instruction manual for the vital acts registry official, that describes all the different life circumstances in which birth certificate is issued and what to do in that case. For fun of course. We don't have the case law here, so all the stuff is nicely codified in one executive act and there is a lot of it.

But lawyers, like doctors and cops are overexposed to the high entropy side of things, which I thing warps their perspective.

BOOSTERHIDROGEN•6mo ago

How do you consistently write a journal?

tra3•6mo ago

I’m experimenting with a prompt that interviews me based on my sparse notes and my meeting schedule. It’s only been a week though, so hard to say if it’ll stick.

UnAutomating the Economy: More Labor but at What Cost?

Show HN: Gettorr – Stream magnet links in the browser via WebRTC (no install)

Statin drugs safer than previously thought

Handy when you just want to distract yourself for a moment

More States Are Taking Aim at a Controversial Early Reading Method

AI will not save developer productivity

How I do and don't use agents

BTDUex Safe? The Back End Withdrawal Anomalies

Show HN: Compile-Time Vibe Coding

Show HN: Ensemble – macOS App to Manage Claude Code Skills, MCPs, and Claude.md

PR to support XMPP channels in OpenClaw

Twenty: A Modern Alternative to Salesforce

Raspberry Pi: More memory-driven price rises

Level Up Your Gaming

Di.day is a movement to encourage people to ditch Big Tech

Show HN: AI generated personal affirmations playing when your phone is locked

Show HN: GTM MCP Server- Let AI Manage Your Google Tag Manager Containers

Launch of X (Twitter) API Pay-per-Use Pricing

Facebook seemingly randomly bans tons of users

Global Bird Count Event

What Is Ruliology?

Jon Stewart – One of My Favorite People – What Now? with Trevor Noah Podcast [video]

P2P crypto exchange development company

Vocal Guide – belt sing without killing yourself

Write for Your Readers Even If They Are Agents

Knowledge-Creating LLMs

Maple Mono: Smooth your coding flow

Sid Meier's System for Real-Time Music Composition and Synthesis

Show HN: Slop News – HN front page now, but it's all slop

Show HN: Empusa – Visual debugger to catch and resume AI agent retry loops

UnAutomating the Economy: More Labor but at What Cost?

Show HN: Gettorr – Stream magnet links in the browser via WebRTC (no install)

Statin drugs safer than previously thought

Handy when you just want to distract yourself for a moment

More States Are Taking Aim at a Controversial Early Reading Method

AI will not save developer productivity

How I do and don't use agents

BTDUex Safe? The Back End Withdrawal Anomalies

Show HN: Compile-Time Vibe Coding

Show HN: Ensemble – macOS App to Manage Claude Code Skills, MCPs, and Claude.md

PR to support XMPP channels in OpenClaw

Twenty: A Modern Alternative to Salesforce

Raspberry Pi: More memory-driven price rises

Level Up Your Gaming

Di.day is a movement to encourage people to ditch Big Tech

Show HN: AI generated personal affirmations playing when your phone is locked

Show HN: GTM MCP Server- Let AI Manage Your Google Tag Manager Containers

Launch of X (Twitter) API Pay-per-Use Pricing

Facebook seemingly randomly bans tons of users

Global Bird Count Event

What Is Ruliology?

Jon Stewart – One of My Favorite People – What Now? with Trevor Noah Podcast [video]

P2P crypto exchange development company

Vocal Guide – belt sing without killing yourself

Write for Your Readers Even If They Are Agents

Knowledge-Creating LLMs

Maple Mono: Smooth your coding flow

Sid Meier's System for Real-Time Music Composition and Synthesis

Show HN: Slop News – HN front page now, but it's all slop

Show HN: Empusa – Visual debugger to catch and resume AI agent retry loops

Tell HN: Thing I learned this year was keeping a work journal

Comments