News for hackers. Stuff that matters.
Re:Ask HN: Good open source repos with decision process? by Jugurtha on Wednesday January 11, 2023 @03:24PM (#34344119)
If you'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.
Re:Ask HN: Good open source repos with decision process? by superdeeda on Wednesday January 11, 2023 @05:54PM (#34346260)
This sounds right up your alley: http://www.aosabook.org/en/index.html
Re:Ask HN: Good open source repos with decision process? by AlexITC on Wednesday January 11, 2023 @09:14PM (#34348232)
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: https://github.com/wiringbits/scala-webapp-template/blob/mas...

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.

In retrospective, I should have started doing this many years ago.