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?