Writing code for computers is challenging, but writing code for humans is even trickier. Crafting user-friendly frameworks, libraries, and APIs requires considering the mental models of those interacting with the code. Feedback from experienced users is valuable, but ensuring easy onboarding for new users is essential in a saturated market of dev tools. Humans learn from examples, not just core concepts. Avoid overwhelming users with unnecessary complexity by minimizing new concepts to understand. Programability and judicious use of defaults and syntactic sugar can enhance user experience. Ultimately, creating intuitive and adaptable tools that empower users to be creative is key. Be mindful of the challenges in designing for the first-time user, much like producing a hit pop song.
https://erikbern.com/2024/09/27/its-hard-to-write-code-for-humans.html