-
Sub-task
-
Resolution: Unresolved
-
Major
-
None
-
7.0
Excerpt from minimalism workshop notes[1]:
Intro is too marketing-y, too dense - simplify, shorten, focus on the technical details
Includes a lot of marketing terms (fast, flexible, easy, etc.). “Easy” is esp problematic - sets users up for resentment if they have trouble installing, etc.
Also “fast” is problematic
Remove “you” where possible
Break first paragraph of Ch. 1 to make important info easier to find
Use of “your” is connected to marketing view, though it can encourage user connections
Eliminate comparisons with earlier versions (“like never before” etc.) - most users of documentation are new adopters
Be careful with metaphors - “glue in the toolbox” does not sound appealing, since nobody wants their tools covered in glue
[1]https://docs.google.com/document/d/1ax_oG2aq7CSzou_2D28ZvnkeEDHMMzBw2zf-kYX8j7M/edit#