Hacker News new | ask | show | jobs
by ser0 1952 days ago
Along the lines of an ADR, another useful document to have is Decisions and Opinions. Often choices are subjective, highlighting these will let contributors know about your preferences for the project. Often these relate more to linting styles, choice of libraries, etc.
1 comments

We have something similar in https://github.com/rust-analyzer/rust-analyzer/blob/master/d....

An interesting systemsy difference is that missing style.md means more work for maintainers (as they need to do more cleanup), while missing architecture.md means more work for contributors.