Developer Advocate, SF City Team | IBM
When you’re working a tutorial or demo code it can be really tempting to simplify or abstract away everything that isn’t immediately part of the technology you’re explaining.
However, developers don’t develop in a vacuum, and your examples shouldn’t take place in that frictionless universe beloved by physicists, either.
In this talk, you’ll learn how to add even more value to the content you produce for developers by including helpful and useful information (and modeling good developer behavior!) such as:
By making explicit the implicit assumptions that experienced developers make around setup, environment, tooling, and security concerns, you help improve your audience’s understanding of best practices while you educate them about your product or service.
Developers may not use your product forever, but they will always remember (and appreciate!) the advocate or company that helped them find the time-saving tool or editor hack that they now use every day!