Uploaded image for project: 'AMQ Documentation'
  1. AMQ Documentation
  2. AMQDOC-2892 General notes from minimalism workshop
  3. AMQDOC-2898

Minimalism workshop notes on first section of Introducing AMQ

XMLWordPrintable

      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#

              Unassigned Unassigned
              rhn-support-pfestoso_jira Phil Festoso (Inactive)
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

                Created:
                Updated: