One thing that would help a lot would be more applied examples with documentation; often we define things in very generic and mathsy terms, and leave the “and here’s when you’d use that” up to the reader. I think generally more examples using some business modelling would help a lot with onboarding; applied examples, instead of simply defining things correctly. E.g. instead of FooBar, maybe User/Database or CreditCard/Transaction and sort of lower the abstraction level. It doesn’t have to replace the mathematical rigour, but learning via ~3 examples really allows people’s pattern recognition to kick in vs trying to learn from first principles.
5 Likes