Upcoming event:
I'm giving an API documentation workshop in Los Angeles, California, on January 23, 2020. Check it out on EventBrite. Input needed:
I'm gathering data about trends in developer documentation for 2020. If you write docs for developers, please take this survey. (You can view the ongoing results here.)Articulating stories that influence product adoption (new article in Simplifying Complexity series)
I added a new article in my ongoing series about simplifying complexity. The article is called Articulating the invisible stories that influence product adoption or rejection and explores why adoption of our products among users doesn't often live up to our expectations. I argue that we need to articulate the story we're telling about the product as well as the story users tell, and identify whether the two are in alignment. Note that you can both read and listen to this article, since I created an audio recording for it.
Listen to this post:
You can download the MP3 file, subscribe in iTunes, or listen with Stitcher.
Here’s a summary:
In any documentation scenario, there are usually at least two competing stories: the company’s story about their product, and the user’s story. The two stories don’t always align. For a product or feature to be successful, the overall story about that product needs to align with the user’s story. These stories aren’t always apparent, and learning to see them constitutes a complex task, since you have to reduce a sea of action and noise down to its essence. The misalignment of these stories often explains why products fail.
Continue reading: Articulating the invisible stories that influence product adoption or rejection
