Your SlideShare is downloading. ×
One Writer’s Perspective: How Structured XML Authoring Changes How You Work
Upcoming SlideShare
Loading in...5
×

Thanks for flagging this SlideShare!

Oops! An error has occurred.

×
Saving this for later? Get the SlideShare app to save on your phone or tablet. Read anywhere, anytime – even offline.
Text the download link to your phone
Standard text messaging rates apply

One Writer’s Perspective: How Structured XML Authoring Changes How You Work

1,125

Published on

Presented at DocTrain East 2007 Conference by Amanda Cross -- In the same way that learning a foreign language can make you a better speaker of your native language, it took moving out of a structured …

Presented at DocTrain East 2007 Conference by Amanda Cross -- In the same way that learning a foreign language can make you a better speaker of your native language, it took moving out of a structured authoring environment for me to realize how much structure had freed my time to expand my skill set. After a few months of fretting over the position of page breaks and enforcing my own heading hierarchy, I was pulling my hair out. “I’m trying to bake a cake,” I thought, “why am I stuck milling my own flour?”

Many tasks are done well (or well enough) by a computer and do not need to occupy a professional writer’s time. However, many document authors are threatened by the idea of structured writing because they fear that if writing a document is easy, then their company won’t need them to do it anymore. The fact is that writing a structured document is easy, but that doesn’t make the writer redundant. To the contrary, it gives the writer the opportunity to expand their influence to areas such as internal training, interface design, and quality management.

This session is for those interested in the time savings and opportunities for professional development that I discovered thanks to the implementation of structured authoring in my documentation department. After this session, you’ll consider the benefits that you might realize with a similar move.

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

  • Be the first to like this

No Downloads
Views
Total Views
1,125
On Slideshare
0
From Embeds
0
Number of Embeds
1
Actions
Shares
0
Downloads
42
Comments
0
Likes
0
Embeds 0
No embeds

Report content
Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
No notes for slide

Transcript

  • 1. One Writer’s Perspective: How Structured XML Authoring Changes How You Work
  • 2. About Me
    • Writing the structured docs since 2001.
    • Designing the structured docs since 2004.
    • Implementing the structured docs since 2006.
  • 3. Hating Structure
    • Filling in the blanks on a Microsoft Word template prevented me from giving the topic the unique treatment that it deserved.
  • 4. Hating Lack of Structure
    • Starting with a blank document prevented me from expanding my influence in the project, the team, and the company.
  • 5. How Structure Makes Life Easier
    • Researching
    • Asking questions in meetings
    • Drafting docs
    • Getting reviews
    • Putting features in perspective
    • Updating docs
    • Writing predictable docs
  • 6. How Structure Makes Life Easier
      • Structuring the documentation can change the way a whole project team thinks about features.
  • 7. How Structure Makes Life Harder
    • Changing you paradigm
    • Accepting that information can be simple
    • Learning many new technologies
    • Inventing new delivery mechanisms
    • Expanding your workload
    • Writing for all outputs and for ease of localization
  • 8. How Structure Doesn't Make Life Harder
    • Creativity
    • Aesthetics
    • Autonomy
    • Job security
  • 9. Thank You
      • Amanda Cross
      • Structured Writing Evangelist
      • [email_address]

×