Vlad's Roam Garden

Powered by 🌱Roam Garden

examples simplify adoption of technology

Taking a complete example of something and changing it to fit your needs is far easier than making something to work from ground-up using underlying technologies.

This is because starting from the example limits the amount of things you need to learn at the same time. Both in the sense of

number of technologies

and in a sense of figuring out how they interact with each other.

You're able to focus on the small change that you care about instead of getting bogged down in the infrastructure setup.

discoverability is a very important part of how easy it is to adopt new technology. Examples serve as a kind of "discoverability aid" - they don't really improve the "natural discoverability" but they give you the rails to hold on to while you fumble in the dark for understanding.

Gradle has terrible discoverability story, but a decent number of examples, which makes it a decent build tool

TLDR pages make life in command line a bit brighter

Referenced in

consider constraining your system to give it desired properties

examples simplify adoption of technology - Examples, allow you to look at the system from the more concrete/less abstract standpoint. Allowing users to more gradually comprehend the overall system