Post-conference workshop at tcworld India 2012. Provides background on structured authoring, XML, planning your topics, writing topics, and writing for re-use.

1. Workshop: XML and Structure Simon Bate Scriptorium Publishing

3. Sr. Technical Consultant at Scriptorium

4. Certified Technical Trainer

5. 30+ years Tech Comm experience

6. 5 years of DITA and DITA OT experience

8. Analyze

9. Develop strategy

10. Implement

11. Transform

12. Train

14. XML

17. Typically implemented with software that verifies whether units of content follow a structure definition template

19. Elements and content identified with semantic tags

20. Formatting is automated

22. and context

25. Elements contain text or other elements.

26. Elements are organized in a hierarchical structure tree.

27. Elements have a relationship to one another.

29. Syntax

30. Defining structure

32. Developed by W3C

33. Successor to SGML and HTML

36. Elements are opened and closed.

37. Empty elements are closed.

38. Attributes are quoted.

44. Attributes and possible values

45. XML and Structured Authoring Structured Authoring XML A concept A technology Adds hierarchy to information Expresses hierarchical information Adds consistency to information Provides mechanisms for ensuring consistency Does not require XML Does not have to be structured

47. Roles

48. Milestones

49. Structure analysis

50. Structure definition

52. Training

53. Documentation

54. Change management

55. Transition support

56. Evaluation

59. Concise

60. Focused

61. Free-standing

62. Audience-specific

63. Self-labeling

65. Can be re-organized later

66. Not narrative

68. Only provides the necessary information

69. Active voice

70. Present tense

72. Identifiable purpose

74. Contains enough information

76. Don't make the reader look for their section

77. Can use filtering

80. Often from Marketing use cases

81. Talk with developers

83. Identify necessary concepts

84. Identify reference information

87. Types of books

89. http://www.youtube.com/watch?v=LRBIVRwvUeE

91. Context-free

92. Generalized

93. Reuse techniques

101. Size

102. Color

104. Filtering

105. Maps

109. Or other docs

112. User level (beginner, advanced)

113. Permissions (user, super user)

114. Product or product version

116. Individual topics reused in different documents

118. Common sets of instructions

119. Product descriptions

122. Review and mark up the sample

124. Context

125. Colloquialisms

126. Pronouns

127. Possible fragments

128. Possibly filtered text

132. Questions?

133. Contact information Simon Bate Scriptorium Publishing www.scriptorium.com [email_address] twitter: @simonbate +1.919.433.2606