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.

Are AI agents ready for the workplace? A new benchmark raises doubts

Show HN: AI Watermark and Stego Scanner

Clarity vs. complexity: the invisible work of subtraction

Solid-State Freezer Needs No Refrigerants

Ask HN: Will LLMs/AI Decrease Human Intelligence and Make Expertise a Commodity?

From Zero to Hero: A Brief Introduction to Spring Boot

NSA detected phone call between foreign intelligence and person close to Trump

How to Fake a Robotics Result

It's time for the world to boycott the US

Show HN: Semantic Search for terminal commands in the Browser (No Back end)

The AI CEO Experiment

Speed up responses with fast mode

MS-DOS game copy protection and cracks

Updates on GNU/Hurd progress [video]

Epstein took a photo of his 2015 dinner with Zuckerberg and Musk

MyFlames: Visualize MySQL query execution plans as interactive FlameGraphs

Show HN: LLM of Babel

A modern iperf3 alternative with a live TUI, multi-client server, QUIC support

Famfamfam Silk icons – also with CSS spritesheet

Apple is the only Big Tech company whose capex declined last quarter

Reverse-Engineering Raiders of the Lost Ark for the Atari 2600

Show HN: Deterministic NDJSON audit logs – v1.2 update (structural gaps)

The Greater Copenhagen Region could be your friend's next career move

Do Not Confirm – Fiction by OpenClaw

The Analytical Profile of Peas

Hallucinations in GPT5 – Can models say "I don't know" (June 2025)

What AI is good for, according to developers

OpenAI might pivot to the "most addictive digital friend" or face extinction

Show HN: Know how your SaaS is doing in 30 seconds

ClawdBot Ordered Me Lunch

Are AI agents ready for the workplace? A new benchmark raises doubts

Show HN: AI Watermark and Stego Scanner

Clarity vs. complexity: the invisible work of subtraction

Solid-State Freezer Needs No Refrigerants

Ask HN: Will LLMs/AI Decrease Human Intelligence and Make Expertise a Commodity?

From Zero to Hero: A Brief Introduction to Spring Boot

NSA detected phone call between foreign intelligence and person close to Trump

How to Fake a Robotics Result

It's time for the world to boycott the US

Show HN: Semantic Search for terminal commands in the Browser (No Back end)

The AI CEO Experiment

Speed up responses with fast mode

MS-DOS game copy protection and cracks

Updates on GNU/Hurd progress [video]

Epstein took a photo of his 2015 dinner with Zuckerberg and Musk

MyFlames: Visualize MySQL query execution plans as interactive FlameGraphs

Show HN: LLM of Babel

A modern iperf3 alternative with a live TUI, multi-client server, QUIC support

Famfamfam Silk icons – also with CSS spritesheet

Apple is the only Big Tech company whose capex declined last quarter

Reverse-Engineering Raiders of the Lost Ark for the Atari 2600

Show HN: Deterministic NDJSON audit logs – v1.2 update (structural gaps)

The Greater Copenhagen Region could be your friend's next career move

Do Not Confirm – Fiction by OpenClaw

The Analytical Profile of Peas

Hallucinations in GPT5 – Can models say "I don't know" (June 2025)

What AI is good for, according to developers

OpenAI might pivot to the "most addictive digital friend" or face extinction

Show HN: Know how your SaaS is doing in 30 seconds

ClawdBot Ordered Me Lunch

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

Comments