Hacker News new | ask | show | jobs
by shermantanktop 442 days ago
A well-documented system would explain all decisions. A well-designed system would enable the user to learn a small set of principles and apply them in adjacent areas successfully without reference to documementation.

As you say, I am used to checking the docs in Linux. It’s the convention that no convention shall be assumed. Is that good design?