M block2 istc_talk_sept2010

644 views
560 views

Published on

Martin Block's presentation at TCUK 2010.

Published in: Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
644
On SlideShare
0
From Embeds
0
Number of Embeds
1
Actions
Shares
0
Downloads
14
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

M block2 istc_talk_sept2010

  1. 1. Slide 1: A new product to document...<br />
  2. 2. Slide 2: Lots of right-clicking the tree…<br />
  3. 3. Slide 3: Why not capture ‘right-click/select/do/result’ in one picture?<br />
  4. 4. Slide 4: Exploded view...<br />
  5. 5. Slide 5: Using text boxes/arrows to annotate a completed dialog box…<br />
  6. 6. Slide 6: Using a cascade of images to illustrate a progression...<br />
  7. 7. Slide 7: Shows the user (a) the tool, (b) what to right-click, (c) what menu item to select, and (d) how to complete the resulting dialog box.<br />
  8. 8. Slide 8: Step-by-step illustration of how to complete a dialog box…<br />
  9. 9. Slide 9: Picture representation of paths to files…<br />
  10. 10. Slide 10: What happens on completing a task... <br />
  11. 11. Slide 11: What is the effect of changing different settings..... <br />
  12. 12. Slide 12: Illustrating a concept…<br />
  13. 13. Slide 13: Explaining a concept…<br />
  14. 14. Slide 14: Documenting a large dialog box broken into discrete compartments...<br />
  15. 15. Slide 15: Single picture showing system architecture and software requirements...<br />
  16. 16. Slide 16: Illustration of what a set of display options means in practice...<br />
  17. 17. Slide 17: Page-by-page descriptions of wizard pages...<br />
  18. 18. Slide 18: For some wizard screens, text boxes will not suffice and a fully documented procedure is required...<br />
  19. 19. Slide 19: Overview of a procedure, with constituent steps matching the table of contents...<br />
  20. 20. Slide 20: The complete picture...<br />
  21. 21. Slide 21: Map of web pages…<br />
  22. 22. Slide 22: Circular progression through (in this case) a set of screens…<br />
  23. 23. Slide 23: If picture width is an issue for you (that is, you may occasionally need to crop pictures to make them narrower), then consider what ‘Message Box’ style is in force on your PC.<br />Here, ‘Windows XP style’ (left) is more suitable than ‘Windows Classic Style’ (right) because it has a constant pattern across its width, allowing for seamless cropping:<br />
  24. 24. Slide 24: Make sure that any field entries in pictures are sensible and help to clarify what is going on…<br />
  25. 25. Slide 25: Names of tree entries chosen to strengthen the text...<br />
  26. 26. Slide 26: Be sure to remove or edit any mention to real people, places , IP addresses and so on….<br />
  27. 27. Advantages:<br /><ul><li>Conveys lots of information quickly and clearly
  28. 28. Visually appealing
  29. 29. Better for the user</li></ul>Disadvantages:<br /><ul><li>Time-consuming
  30. 30. Labour-intensive
  31. 31. Can be excessive and even unhelpful (overkill?)
  32. 32. Increases document length and weight
  33. 33. Ages documents more quickly</li>

×