frontpage.
newsnewestaskshowjobs

Open Source @Github

fp.

Open in hackernews

How to Write an Effective Software Design Document

https://refactoringenglish.com/excerpts/write-an-effective-design-doc/
3•mtlynch•2h ago

Comments

blinkbat•1h ago
The example app is making me upset... Instagram redux? Why
mtlynch•1h ago
It's for private photo sharing with family or close friends. It's more like an open-source, self-hostable TinyBeans or PhotoCircle. I explain the motivation more in the design doc:

https://refactoringenglish.com/excerpts/write-an-effective-d...

blinkbat•1h ago
wouldn't these small groups just like... send an email? group chat?
mtlynch•1h ago
The target audience of the app is me and my wife. This is a "home-cooked meal" app.[0] If it's useful to other people, I'm glad, but I'm primarily building it for myself for the pleasure of building and the satisfaction of a tool that works exactly how I want it to work.

You could approximate it with email, but I want things that you can't do with email like letting recipients control the frequency of emails, making high-res images available without bloating everyone's inboxes.

[0] https://www.robinsloan.com/notes/home-cooked-app/

tylerhackbart•1h ago
The "what's the penalty for being wrong" question is the part I'd keep. That one works at any scale.

But I spent five years on a solo app and never wrote anything close to this. Not on principle event, just the design just kept moving. The decisions that ended up mattering weren't ones I could have named on day one, they were things I cut in year three once I actually understood what the app was for. If I'd written the objective sentence up front I'd have locked in a version that turned out wrong. The clarity came from building the thing, not from describing it first.

For coordinating people or catching a security flaw before it ships, sure, all of this makes sense. Solo just runs on different rules I guess.

mtlynch•1h ago
Thanks for reading!

>But I spent five years on a solo app and never wrote anything close to this. Not on principle event, just the design just kept moving.

Yeah, I agree that for solo projects, it makes sense to greatly scale down the design phase. In a lot of cases, you'd scale design down to zero if you need user feedback to figure out what to build.

But even for solo projects, if I keep at it for months or years, I eventually get to the point where some problem is hard enough that I need to do some upfront design, even if it's not as formal as a whole design doc.

Linus calls sched_ext's file layout "disgusting"

https://www.phoronix.com/news/Linux-Sched-Ext-Restructured
1•p_stuart82•57s ago•0 comments

Announcing Mozilla.org, a New 501(C)(3) Nonprofit

https://blog.mozilla.org/en/mozilla/news/announcing-mozilla-org-new-non-profit/
1•wintermute2dot0•1m ago•0 comments

How to Resolve Promises Sequentially in JavaScript

https://www.jamdesk.com/blog/resolve-promises-sequentially-javascript
1•jamdesk•2m ago•0 comments

Close Encounters of the Imagined Kind

https://argumenta.blog/posts/close-encounters-of-the-imagined-kind
1•cbiaivids•2m ago•0 comments

AI coding agents need evidence-first review, not just cheaper routing

https://undes.app/blog/cheaper-ai-code-generation-engineering-cost
2•CalmAngler•3m ago•1 comments

I rewrote PostHog's SQL parser, 70x faster, while barely looking at the code

https://posthog.com/blog/sql-parser
4•robbie-c•4m ago•0 comments

Forensic Analysis: Hal Finney Missed the Bitcoin Launch

https://twitter.com/raw_avocado/status/2069786136998785412
1•alexwaltz•4m ago•1 comments

Show HN: Screen recording your crappy startup

https://www.youtube.com/channel/UC2DA9fAIEVtAhy_1TdQDLHQ
1•johnwheeler•5m ago•0 comments

Tata Electronics confirms cyberattack as hackers leak data

https://www.bleepingcomputer.com/news/security/tata-electronics-confirms-cyberattack-as-hackers-l...
1•Brajeshwar•7m ago•0 comments

Co-Packaged Optics (CPO) – Scaling with Light for the Next Wave of Interconnect

https://newsletter.semianalysis.com/p/co-packaged-optics-cpo-book-scaling
1•JumpCrisscross•9m ago•0 comments

Fossils of archaic human found in a cave are the same sex

https://www.cnn.com/2026/06/24/science/homo-naledi-fossils-same-sex
1•Tomte•9m ago•0 comments

Elon should remain focused on Mars; diverting to the Moon would be a mistake

https://quillette.com/2026/03/05/musk-is-enticed-by-the-lunar-siren-moon-space/
1•speckx•12m ago•0 comments

Beyond expands AI offering with revenue management tools

https://shorttermrentalz.com/news/beyond-expands-ai-revenue-management/
1•thomcrowe•13m ago•0 comments

Four by Three Puzzle

https://www.hankgreen.com/fourbythree
1•marvinborner•16m ago•0 comments

Show HN: SparQ Pulse – Self-hosted, GitHub-native project management

https://github.com/gosparQ/sparq
1•aidanurbina•16m ago•0 comments

Robert Stroud

https://en.wikipedia.org/wiki/Robert_Stroud
1•petethomas•16m ago•0 comments

Show HN: Piranha Chat – The second screen for live events.

https://piranha.chat/
1•Mike-Mait•16m ago•0 comments

A $45M Donation Brought Larry Ellison Deeper into Trump's Circle

https://www.wsj.com/politics/policy/how-a-45-million-donation-brought-larry-ellison-deeper-into-t...
3•petethomas•17m ago•0 comments

Vibe Coding to Agentic Engineering with Claude Code

https://www.apimatic.io/blog/agentic-engineering-claude-code
1•m3h•17m ago•0 comments

Popup Conversion Wizard – All-in-one premium popup app

https://apps.shopify.com/orange-popup
1•Vectortech•19m ago•1 comments

Engine No. 1000: Destinus reaches industrial-scale turbojet production in Europe

https://www.destinus.com/post/engine-no-1000-destinus-reaches-industrial-scale-turbojet-productio...
1•Someone•20m ago•0 comments

CFPB to Propose Data Rationing on Fintechs in Open Banking Plan

https://news.bloomberglaw.com/banking-law/cfpb-to-propose-data-rationing-on-fintechs-in-open-bank...
1•petethomas•20m ago•0 comments

Meta releases a new AI app for creators

https://techcrunch.com/2026/06/24/facebook-rolls-out-an-ai-companion-app-for-creators/
1•bogdiyan•20m ago•0 comments

Portfolio doesn't need to be boring

https://feralui.vercel.app/#/deskfolio
2•solutionB•22m ago•0 comments

Show HN: Get AI to recommend your product or service

https://plauditlabs.com
2•cwbuilds•22m ago•1 comments

OpenAI unveils its first custom chip, built by Broadcom

https://techcrunch.com/2026/06/24/openai-unveils-its-first-custom-chip-built-by-broadcom/
33•jamdesk•22m ago•60 comments

Home Broadband Is 5G's Surprise Killer App

https://spectrum.ieee.org/fixed-wireless-access
3•Brajeshwar•23m ago•1 comments

Fable Back on AWS Bedrock

https://twitter.com/synthwavedd/status/2069813760622043483
2•mkw5053•24m ago•0 comments

Show HN: Imara – policy enforcement layer for MCP agents (npx imara)

https://github.com/Dnakitare/imara
1•dnakitare•25m ago•0 comments

Peach – free, open source, zero-knowledge password manager with no server

https://peachpasswords.com/
2•ashasoftware•25m ago•0 comments