TE
TechEcho
Home24h TopNewestBestAskShowJobs
GitHubTwitter
Home

TechEcho

A tech news platform built with Next.js, providing global tech news and discussions.

GitHubTwitter

Home

HomeNewestBestAskShowJobs

Resources

HackerNews APIOriginal HackerNewsNext.js

© 2025 TechEcho. All rights reserved.

Ask HN: Good open source repos with decision process?

4 pointsby lapaz17over 2 years ago
Some devs say, you learn programming by reading code but sometimes reading is not enough. I want to learn story behind it (why it is written like that). Any repos with good articles providing history?

3 comments

AlexITCover 2 years ago
Shameless plug, while this does not have full articles explaining decision process, I started tracking design decision with a short summary and the date those choices were introduced: <a href="https:&#x2F;&#x2F;github.com&#x2F;wiringbits&#x2F;scala-webapp-template&#x2F;blob&#x2F;master&#x2F;docs&#x2F;design-decisions.md">https:&#x2F;&#x2F;github.com&#x2F;wiringbits&#x2F;scala-webapp-template&#x2F;blob&#x2F;mas...</a><p>This has been helpful to my team because there are times where something does not seem right, or, it just seems a weird choice, documenting the reasoning can help new team members to understand this.<p>In retrospective, I should have started doing this many years ago.
Jugurthaover 2 years ago
If you&#x27;re at the repo level, then read the commit messages, release notes, and issues and comments linked to a pull-requests. They will contain the rationale and discussions on technical decisions and the tradeoffs behind them.
superdeedaover 2 years ago
This sounds right up your alley: <a href="http:&#x2F;&#x2F;www.aosabook.org&#x2F;en&#x2F;index.html" rel="nofollow">http:&#x2F;&#x2F;www.aosabook.org&#x2F;en&#x2F;index.html</a>