Principles for simplifying complexity
I'm giving an API documentation workshop in San Francisco, California, on November 19, 2019. Check it out on EventBrite and register today to receive a $100 early bird discount.
- Simplifying Complexity
- Introduction
- Principle 1: Let users switch between macro and micro views
- Principle 2: Make information discoverable as the user needs it
- Principle 3: Ensure information harmony in the larger landscape
- Principle 4: Reduce and distill vast information down to its essence
- Principle 5: Conform to the patterns and expectations of the genre and schemas
- Principle 6: Reconstruct the absent user
- Principle 7: Reduce the complexity of technical language
- Principle 8: Align the product story with the user story
- Principle 9: Iterate and increment on content following an agile approach
- Principle 10: Hide complexity with UX design (such as through JS or CSS)
- Principle 11: Be both a generalist and specialist at the same time
- How to evaluate documentation
Sponsors
Search results
