3 ms·
Let’s say I want to write a “best practices” guide - where does it fall? Should each topic contain all 4 quadrants? Example topic is “Explicitness vs concisene
by xixixao 6y ago
Let’s say I want to write a “best practices” guide - where does it fall? Should each topic contain all 4 quadrants?
Example topic is “Explicitness vs conciseness in naming” (it could be (over)simplified to “prefer explicit over concise naming”).
- DanieleProcida 6y agoPerfect example (in the scheme) of an explanation/background/key concepts/discussion/whatever you call it document. That's where you weigh up options, discuss alternatives, etc. If it's something you could read about in the bath or talk about over dinner, it goes there.
- xixixao 6y agoPerhaps, but I'm not sure it's so clear cut. The best practice should be concrete - it should have code examples. It should be beginner friendly (since it's beginners who will use it most often).
- xixixao 6y agoGreat "best practices" example is just now on homepage: https://startup-cto.net/10-bad-typescript-habits-to-break-this-year/ https://startup-cto.net/10-bad-typescript-habits-to-break-th...