Hot take: A good notes app should be merely a presentation layer that’s really good at manipulating Markdown files.

#notes #markdown

Hot take: A good notes app should be merely a presentation layer that’s really good at manipulating Markdown files.

#notes #markdown

I've been playing around with streamlining documentation by pulling JSDoc comments straight into an #11ty website. I'll try and write it up once I get it to somewhere I'm a bit happier with.

For example, this page is partially generated based on the comments directly in the JavaScript code

https://gruber.r0b.io/postgres/

https://github.com/robb-j/gruber/blob/main/postgres/postgres-migrator.ts

It's pretty cool, and hopefully makes the documentation so much closer to edit when the code itself changes, Though I think there needs to be more curatability in it.

#Notes#Gruber

I've been playing around with streamlining documentation by pulling JSDoc comments straight into an #11ty website. I'll try and write it up once I get it to somewhere I'm a bit happier with.

For example, this page is partially generated based on the comments directly in the JavaScript code

https://gruber.r0b.io/postgres/

https://github.com/robb-j/gruber/blob/main/postgres/postgres-migrator.ts

It's pretty cool, and hopefully makes the documentation so much closer to edit when the code itself changes, Though I think there needs to be more curatability in it.

#Notes#Gruber

"If you wanna know how I write 2-3 books per year, blame the #cognitiveprosthesis of #blogging, which forces me to apply rigor to the #notes I take, and rewards me with a searchable database of everything I've ever found important, while stimulating a constant mnemonic rejuggling of all those thoughts that crystallizes into an endless stream of novel synthetic insights and road-tested ways to express them."
The @pluralistic strategy you'll want to learn.
https://pluralistic.net/2025/07/28/twiddlehazard/

"If you wanna know how I write 2-3 books per year, blame the #cognitiveprosthesis of #blogging, which forces me to apply rigor to the #notes I take, and rewards me with a searchable database of everything I've ever found important, while stimulating a constant mnemonic rejuggling of all those thoughts that crystallizes into an endless stream of novel synthetic insights and road-tested ways to express them."
The @pluralistic strategy you'll want to learn.
https://pluralistic.net/2025/07/28/twiddlehazard/