Live data from Hacker News

Using an engineering notebook

ntietz.com

101–110 of 161 posts

Re: Using an engineering notebook

#101
> I'm talking about a practice of recording notes as you work on things, documenting what you're doing and why.

I've been using GitHub Issues threads for this for a few years now, in both public and private repos.

They work great for this. You can copy and paste code, images and references to code in repos to them, you can link them together, they offer useful API access, work on laptop and phone and are backed up by GitHub.

Re: Using an engineering notebook

#102
I keep a medium moleskine with the dots. Great for sketching UI designs or block diagrams. Dots are just enough guidance for technical drawing but not as distracting as lines.

So much more respectful in meetings to use pen and notebook than to use a digital writing medium. Not sure why but that’s the vibe I feel.

Re: Using an engineering notebook

#103
post #101

> I'm talking about a practice of recording notes as you work on things, documenting what you're doing and why. I've been using GitHub Issues threads for this for a few years now, in both public and private repos. They work great for this. You can copy and paste code, images and references to code in repos to them, you can link them together, they offer useful API access, work on laptop and phone and are backed up by…

+1 on GitHub issues particularly as they now have:

- parent and child relationships

- the boolean search has gotten much better

- the CLI version integrates well with Claude etc

Re: Using an engineering notebook

#104
post #77
post #52

Earlier quoted context omitted.

> There was a time when a notebook was also a legal document This is still the case in certain fields like policing where, in the United Kingdom at least, an officer's pocket notebook is an important document, albeit with some police forces now moving to electronic solutions for this: https://en.wikipedia.org/wiki/Police_notebook

Journalists should store their notebooks for 7 years.

Or put it in the shredder once the notes are not needed.

Re: Using an engineering notebook

#105

I've done this continually—initially writing in spiral notebooks—since I started writing computer games 40 years ago. When at Apple, where it is probably widely known that there is an internal bug-tracking system called "Radar", a co-worker called my notebook style "John-dar" since I kept copious one-line to-do lists of issues still to resolve, tasks to tackle, etc. When all the circles next to each entry were filled…

What do you use to digitize your Field Notes? I was using EverNote but I’m looking for an alternative.

Re: Using an engineering notebook

#106

Is an engineering notebook a specific kind of notebook? Google has a lot of results for "engineering notebook" but they seem to be all expensive fancy notebooks that have thin gridded paper

No. The author uses the term “engineering notebook” to make it sound different than what humans have already been doing for millennia.

Re: Using an engineering notebook

#107
post #84

Earlier quoted context omitted.

I picked up bullet journaling a few years back and that’s how I track my work: o Sales meeting with Foo Corp - Suggested to Sam that we use PostgreSQL - Made us $X by doing $Y (star drawing) . Fix a thing / In the process of fixing a thing X Done fixing the thing And that’s about it. I write this in an epaper notebook (Supernote Nomad) that I take everywhere in the office. At a glance I can tell you what I’m working…

What is the Nomad like? What were your concerns when selecting an epaper notebook? Which alternatives did you rule out and why? Sorry, just long wanted to get one but the good ones are expensive and I don't want to experiment with that kind of money.

I’m loving the Nomad. I’d buy it again if I lost or broke it.

The Remarkable Move finally pushed me over the edge to trying an epaper device. I bought it, used it, and sent it back[0]. In short, the hardware was great, but the software’s awful. Remember how iOS use to be skeuomorphic not just in appearance but in behavior, like you could only turn one Calendar page at a time because that’s that it’s like to navigate a paper calendar? Move’s software’s like that, with a thousand grating limitations because “that’s now notebooks work”. Can you add a dictionary to the ebook reader? No, because real books don’t have dictionaries! My gut instinct is that they don’t have the engineering resources to implement new features and that’s the excuse they give.

Supernote goes the opposite direction. Its software is leagues better for navigating within books. Like, circle some text on the page, tap an icon to make that a header, and now it appears in the doc’s table of contents. Tap it there and you’ll jump right to it. You can link to other docs. It’s closer to “a book… but better”.

0: https://honeypot.net/2025/10/24/why-im-returning-the-remarka...

Re: Using an engineering notebook

#108

Interesting. I use a paper notebook to but it's the opposite of detailed. I use one when I have several ideas in my head and I need to get them out before I forget some, or when I need to figure something out that's a wee bit too complicated to keep all the bits and bobbles in my brain-RAM. But I write down just enough to offload the memory to paper. They're literal notes. Just enough so that I can remember what I wa…

This is all very familiar. As I work on one task, supporting tasks reveal themselves and I like to write it all down. There is something about writing it vs. typing it, too. Often, I will write notes like "Figure out how to do X,Y,Z" and then I wake up in the middle of the night and the solution is right there.

Re: Using an engineering notebook

#110

Based on this thread, I decided to implement my best take on an online engineering notebook: https://about.workledger.org/ All local first. Happy to get some contributors :)

Did you one-shot this using an AI coding agent? If this was really just now created after reading this article and the comments, it's incredibly impressive.
Post reply on HN