frontpage.
newsnewestaskshowjobs

Made with ♥ by @iamnishanth

Open Source @Github

fp.

Ask HN: Do you allow vibecoded submissions in your open-source projects?

3•sneas•1h ago•4 comments

Ask HN: What are your predictions for 2026?

84•mfrw•2d ago•151 comments

Ask HN: Those making $500/month on side projects in 2025 – Show and tell

424•cvbox•1d ago•495 comments

Tell HN: HN was down

595•uyzstvqs•1d ago•326 comments

Ask HN: What Are You Working On? (December 2025)

437•david927•4d ago•1442 comments

Ask HN: Does anyone understand how Hacker News works?

156•jannesblobel•1d ago•212 comments

Tell HN: Cloudflare Down Again?

8•valtlfelipe•3h ago•6 comments

Ask HN: How do you deal with large, hard-to-read Excel formulas?

5•jack_ruru•11h ago•8 comments

Tell HN: AI coding is sexy, but accounting is the real low-hanging target

64•bmadduma•1w ago•55 comments

Ask HN: If one day AI brain chips become a thing, would you get it?

5•keepamovin•8h ago•20 comments

Ask HN: How do teams remember why infrastructure decisions were made?

5•curious_sre•13h ago•8 comments

Ask HN: Who here is not working on web apps/server code?

12•ex-aws-dude•20h ago•10 comments

Ask HN: Is starting a personal blog still worth it in the age of AI?

63•nazarh•4d ago•75 comments

Ask HN: Is anyone using LLM based document processing in production?

7•asdev•17h ago•6 comments

Computer animator and Amiga fanatic Dick van Dyke turns 100

281•ggm•6d ago•93 comments

Ask HN: Is building a calm, non-gamified learning app a mistake?

86•hussein-khalil•3d ago•122 comments

Ask HN: Should I start a software foundation (goal: help emergency services)?

11•strgcmc•1d ago•0 comments

Is analytics a necessary evil rather than a real value driver?

6•tiazm•21h ago•7 comments

Ask HN: How to fight back against Lovable, Replit, etc. in enterprise products

3•bears123•21h ago•3 comments

GitHub Actions Degraded

3•1qaboutecs•21h ago•0 comments

Ask HN: Is RSS Still Alive?

10•militanz•1d ago•12 comments

Ask HN: Should I Open Source Every Product I Build as an Indie Developer?

6•tomfox2•23h ago•11 comments

Ask HN: If you had to get a non-tech masters degree, what would you go for?

2•highwayman47•23h ago•6 comments

Tell HN: iOS 18.7.3 Update Hidden

5•alemanek•11h ago•2 comments

Ask HN: Etiquette giving feedback on mostly AI-generated PRs from co-workers

4•chfritz•1d ago•4 comments

Ask HN: Why do official-looking emails cause anxiety before I read them?

4•BianDan•1d ago•4 comments

Ask HN: Decentralized Auth for Information Exchange?

2•vxsz•1d ago•3 comments

Ask HN: How can I get better at using AI for programming?

467•lemonlime227•5d ago•466 comments

FWS – pip-installable embedded process supervisor with PTY/pipe/dtach back ends

2•mrsurge•1d ago•0 comments

Breaking Changes in Python-3.14

6•wef•16h ago•6 comments
Open in hackernews

Ask HN: How do teams remember why infrastructure decisions were made?

5•curious_sre•13h ago
On teams I’ve worked with, we often run into systems where nobody really knows why certain configs, services, or architectural choices exist. Docs are outdated, Slack history is messy, and the people who made the decision are often gone. When something breaks, we end up rediscovering the same context over and over. Is this just inevitable on long-lived systems, or do experienced teams have a better way of preserving this kind of context?

Comments

toomuchtodo•12h ago
ADR records. Store as markdown file(s) in the repo.

https://adr.github.io/

https://github.com/adr/madr

curious_sre•11h ago
That makes sense. In your experience, do ADRs actually get revisited during incidents or onboarding, or do they mostly exist as reference docs that people forget about?
toomuchtodo•11h ago
Rarely useful for incidents in my experience, mostly useful for onboarding those new to a codebase or part of a system. It’s a mechanism to preserve institutional knowledge that would otherwise evaporate due to not being represented as code; formalized documentation.

The benefit of this information existing in markdown files is this can also be used with LLMs and RAG if getting a natural language interface to the knowledge might be relevant to your enterprise.

curious_sre•2h ago
That’s helpful context, thanks. In practice, when incidents happen, where do people actually go to reconstruct the “why”? Is it mostly Slack archaeology and asking senior engineers, or is there something else that works better?
gardenhedge•1h ago
Good but needs to be driven by a head of architecture type role incentivizing the practice. Otherwise it's a patchwork of records and largely ignored.
d--b•4h ago
Ah I wanted to make a product to solve this problem. I posted here to see if anyone thought it was worth solving, but nobody seemed to care.

The way I wanted to do this is to create dashboards that would serve at the same time as infrastructure diagrams for documentation and live health monitoring.

Right now, most documentation solutions aren't used on a daily basis so become out of date, because people don't think about it when making changes and fixes.

And monitoring solutions only show you charts of things you're supposed to already know. They're very technically-oriented, and not business-logically oriented, if that makes sense. Like they'll tell you that process x is running on machine m, and that it's running out of ram, but nothing will tell you that process y that depends on x's outputs is going to fail as well.

mmarian•50m ago
After I read your comment, I remembered I posted about it too, and came to the same conclusion ^_^
mmarian•51m ago
Confluence pages, ADRs in github. Not perfect though.