Maslow’s Hierarchy of Needs Applied In Technical Content Publishing

imageMaslow’s hierarchy of needs is well known method when applied for people’s motivation. Once certain level of a need is addressed the person pursues the higher need. It starts with basics like food and shelter and ends with creativity and self-realization or self-actualization as Maslow puts it.

Here is how I applied it when creating highly desired content for specific audience – developers.

First I identified key buckets of what developers would want to have in terms of content and guidance. This is how I came up with Information Architecture for developers using Steven Covey Habits Applied In Technical Content Publishing. When it comes to new technologies developers need the following guidance and content artifacts to be effective and successful:

  • Getting started. This is great as an ice breaker. It usually offers low bar code sample or walkthrough, Hello World style. The idea here is to give confidence to developer about the technology and that it’s easily doable. The downside is when it comes to solving real world problem the Hello World example is not enough by any means.
  • Features descriptions. This is great to have a “static” non-actionable explanation of what’s available shedding some light on the technology and its internals. The downside is that while it can give some clues how to solve real problems developers usually left to their own devices when trying to apply the features to solve.
  • API reference. This is fundamental part every developer usually want to have. It describes each and every little thing about the technology. The downside is as with the features descriptions developers need to resort to the trial and error approach that is full of friction.
  • Scenarios and solution approaches. This is great and effective when trying to find an answer to the question “does it fit my case?” It mitigates the risk of wasting time as in the case with feature descriptions content. The down side is that scenarios and solution approaches content relies heavily on other content types and cannot exist on its own.
  • Step-by-step How-To’s. This is prescriptive walkthroughs. It’s about taking horse to the water and it relies heavily on API reference effectively giving it a meaning.
  • Non-functional (quality) guidelines such as security, performance, troubleshooting. This is great for times when developer in the know how to make things work, and especially when they break. Usually it is critical for production systems vs. evaluation phase.
  • Code samples. This is great when a developers don’t want to start from scratch rather they want to cannibalize readily available working code. The downside is that in many cases it takes ton of effort to make the samples work, and even longer to extract relevant parts that are applicable to specific scenarios at hand.

Said all that, this is the simple model I came up with – the hierarchy of developer’s needs:

imageThis simple model reflects on the fact that in most cases developers, before they start coding, need to understand if the technology can solve their problem. If so, then it would be great to quickly assess it by following simple instructions from zero to working demo. After that it would be great to have some code samples and deep dive features descriptions. Obviously Scenarios and Solutions content is of high value. On other hand, it’s impossible to create high value content out of the thin air, one need to create relevant lower level artifacts such as API reference.

To use this model consider planning and execution phases.

During planning phase you work top down – you collect relevant scenarios that people seek solutions the most. Best is engaging your field representatives and other field authorities. Just collection the list of scenarios. This will serve as a seed of generating the How-To’s list. Looking at the scenarios you will naturally start asking How-To questions. Once the list of How-To’s generated it will ultimately drive the relevant API’s that needs to be documented.

Don't Make Me ThinkDuring the execution phase, you work bottom up – you create the basic fundamental layer of the pyramid, then higher layer until the top which is Scenarios and Solutions.

Such simple and streamlined approach leaves less room to think when creating the content – a good thing for content creators. It also reduces the friction when researching and searching for relevant content – a good thing for content consumer. Thinking less and doing more is one of the principles outlined in the book by Steve Krug Don’t Make Me Think where he outlines the principles of creating friction free content on the Internet. And that is a really good thing.

Maslow’s pyramid seems to me universal tool when approaching any domain. It helps identifying fundamentally needed and highly desired artifacts and then plan and prioritize what to deliver to achieve optimal results.


image by Victor Bezrukov

Posted in: Writing

About the Author:

This blog is dedicated to share simple practices I that get me results.

5 Comments on "Maslow’s Hierarchy of Needs Applied In Technical Content Publishing"

Trackback | Comments RSS Feed

  1. Although I’m no developer, I feel as though this approach could be useful for simply problem solving most situations. Often when I’m developing a range of marketing materials, I use the top down and bottom up approach to complete my list of tasks.

  2. Lew Sauder says:

    This is an excellent way of breaking down and organizing technical content. The Maslow approach is great way of organizing and prioritizing to make the overwhelming seem doable.

  3. alik levin says:

    Yes this approach was instrumental in problem solving and creating actionable work breakdown structures and to high value deliverables.

    Thank you.
    Nicely put!! “make the overwhelming seem doable”, love it.

  4. J.D. Meier says:

    At the end of the day, it paints a value chain, and the ultimate value is from the synergy of the constellation of nuggets, versus just the piece-meal of the parts.

    But that’s the beauty … the pieces are useful, too.

  5. Alik Levin says:

    Nicely put. Each pieces are useful as well as the clusters of the pieces are.

Post a Comment