Live data from Hacker News

Lab Notebooks (2020)

sambleckley.com

21–30 of 70 posts

Re: Lab Notebooks (2020)

#21

A huge downside of writing this down on paper is team collaboration. Imagine that instead this is kept in a tool like Notion which the entire team can access. At first this feels incredibly uncomfortable - your notes are there for everyone to see. However it’s a massive force multiplier because often the work is picked up by someone else later on, and instead of asking you they can self-serve. It’s pretty common that…

> instead of asking you they can self-serve. It’s pretty common that by the time they need it you would no longer be at the company.

All lab notebooks are company property. You don't keep them locked away in your desk or take them with you when you leave. Any current or future employee with the right clearances should be able to serve themselves to the entire archive. No need to ask the original author.

Searchability is by far the most significant advantage of electronic documents, but you can get pretty far with paper notebooks if you keep a decent table of contents. Even better if you regularly scan, OCR, and upload your pages to the archive. IMO the inconvenience of scanning is greatly outweighed by the paper notebook's guarantee of immutability. Tools like Notion make it too easy to erase information, either accidentally or not.

Re: Lab Notebooks (2020)

#22
I always have one of more pages of loose-leaf on my desk. It’s messy, but basically the lowest barrier to entry. And if I’m somewhere else and write something down, it goes in the pile with the other notes when I get back.

A few times a year, I open an org-mode file and start summarizing my notes. Those sheets then get put away, to help keep things a little less messy.

Re: Lab Notebooks (2020)

#23
I started working at a lab where I am the only SWE and everyone else is a scientist. I have a lab notebook, but I don't use it properly (thankfully nobody gets on my case about it). I usually just use it as a short-term working memory, but it helps me keep track of the progress I've made. It's nice to look back on something I was working on two months ago and see all my thoughts written down about which library to use or architecture to use. Looking back at my past struggles gives me a sense of accomplishment and progress.

That said, I usually try to preserve the results of my "experimentation" in documentation with the software, so I can share it with others. It's a good sign when people never talk about X to me, and I end up asking them if they ever used X and they tell me "I just used your documentation". Best feeling ever.

Re: Lab Notebooks (2020)

#24
Does anybody have a reference/example of a lab notebook for software engg ?

If I'm forced to log my thoughts/actions it comes out as either too terse(everthing feels obvious) or it's too verbose and it's often difficult to find the right balance.

Re: Lab Notebooks (2020)

#25

A huge downside of writing this down on paper is team collaboration. Imagine that instead this is kept in a tool like Notion which the entire team can access. At first this feels incredibly uncomfortable - your notes are there for everyone to see. However it’s a massive force multiplier because often the work is picked up by someone else later on, and instead of asking you they can self-serve. It’s pretty common that…

Absolutely not. My working / lab notes capture raw thoughts, often abbreviated and with shortcuts taken. Others would have trouble gleaning much meaning from them, with so many scratched out words, wildly drawn arrows, and peculiar diagrams.

Take my raw notes, rewrite them for another audience, and post those on Notion? Maybe. But it's likely a different document (an essay, tutorial, FAQ) could be rewritten out of my notes, one which would be more useful for my teammates.

Re: Lab Notebooks (2020)

#26
post #9

One advantage of lab notebooks that the article does not mention is that by design, the pages are firmly bound to the book, so you cannot lose them. I started to use lab notebooks because I would otherwise just write thoughts on loose-leaf paper and have a difficult time keeping track of the pages and their order. The lab notebook (or any notebook with firmly bound pages) solves that problem. That said, I don't use l…

As a grad student I have an “official” lab notebook which sits on my lab bench and has all my technical details etc. I also have what I affectionately call my “real” lab notebook which is a stack of loose printer paper at my office desk, full of scribbles, designs, math, random planning and thoughts.

I plan to get it bound and call it my “real” thesis.

Re: Lab Notebooks (2020)

#27
post #13

A huge downside of writing this down on paper is team collaboration. Imagine that instead this is kept in a tool like Notion which the entire team can access. At first this feels incredibly uncomfortable - your notes are there for everyone to see. However it’s a massive force multiplier because often the work is picked up by someone else later on, and instead of asking you they can self-serve. It’s pretty common that…

I agree that it’s useful for the rest of the team to have access to your notes, but I find that it’s far more useful to write my notes with a pen and paper rather than typing them out. It forces me to slow down and think through what I’m doing, in addition to aiding in memorizing the parts of my notes that I find important.

The important point is that the raw notes are for the note-taker. They not only document what you thought, they are themselves a part of and tool for the thinking process. Writing is thinking[1], and the initial results aren't going to be very useful for someone else, because they'll be rambling and messy, with lots of false starts, errors, and just wrong ideas. They're for the author to remember the path to the outcome[2], they are not the outcome itself.

For the rest of the team, those raw notes are source material. That can be the input into lightweight documents like technical memos and decision records.

1. https://www.insidehighered.com/blogs/higher-ed-gamma/writing...

2. https://posts.oztamir.com/the-opposite-of-forgetting-is-writ...

Re: Lab Notebooks (2020)

#29
post #5

The article mentions, but doesn't elaborate, on the purpose of the notebook as a legal document. This was much more important when notebooks could be used to show priority in patent disputes, but only if well kept. My parents were both research scientists. Where my dad worked, the company patent lawyer read and critiqued your notebooks, and maintained the discipline. Many of those rules became unnecessary when the US…

To your specific point, the legal issues are so idiosyncratic. You can’t write an article about them. You can’t tease out the difference between “this is a best practice everyone should follow” and “the patent lawyer is selling the holistic social experience of compliance,” which is the non-trial attorney’s primary product. It’s the same energy as DocuSign: when your biggest competitor is a pen, you know all the bullshit they peddle about timestamps and tracking and custody is just that, bullshit.

It really comes down to, what is your role? Are you making discoveries or working for people who do? Both are very worthy. In my experience, the PIs - and their subordinates who become PIs - they aren’t thinking very hard about lab notebooks and their tactics vary widely. No best practices. However they are focused on maximizing the amount of serendipity they can have per unit time, which tends to devalue how you’re documenting stuff for patent lawyers.

Does Benchling have a manifesto about why you should care about lab notebooks? No. It has a ton of little reactive opinions that are relevant to its sales pipeline. But nothing like “Agile, except for life sciences” which incorporates their software. It’s everything to all people, like most life science software. I know people receive huge grants on promising discoveries in life sciences, and some of their labs have Benchling licenses and don’t use them. The people first authoring the papers use lab notebooks of course, but see this as a small part of their process.

Re: Lab Notebooks (2020)

#30
post #5

The article mentions, but doesn't elaborate, on the purpose of the notebook as a legal document. This was much more important when notebooks could be used to show priority in patent disputes, but only if well kept. My parents were both research scientists. Where my dad worked, the company patent lawyer read and critiqued your notebooks, and maintained the discipline. Many of those rules became unnecessary when the US…

Have you tried quarto markdown? It’s similar to rmarkdown but language agnostic and allows me to think in code in a way that can easily be added to notebooks. To work with them in notebook fashion I can work through one file a day and save the rendered pages in a folder.
Post reply on HN