Tag Archives: minimalist documentation

Learning Ubiq P2: Support Structures

As outlined in Part 1, the traditional style of documentation is antithetical to actual usage.  Style is a major problem, but the delivery mechanisms are just as bad. At best, a manual can be oriented to predefined tasks and known problems, at worst it is a dense technical read with a broad overview intertwined with nitty-gritty details.  Neither approach considers how people actually work with documentation.  Firstly users never consult a manual unless they encounter a problem they cannot solve

Continue Reading →