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

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

on

  • 1,775 views

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.

Statistics

Views

Total Views
1,775
Views on SlideShare
1,757
Embed Views
18

Actions

Likes
0
Downloads
42
Comments
0

3 Embeds 18

http://www.doctrain.com 14
http://localhost 2
http://www.slideshare.net 2

Accessibility

Categories

Upload Details

Uploaded via as OpenOffice

Usage Rights

CC Attribution-ShareAlike LicenseCC Attribution-ShareAlike License

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Processing…
Post Comment
Edit your comment

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

  • One Writer’s Perspective: How Structured XML Authoring Changes How You Work
  • About Me
    • Writing the structured docs since 2001.
    • Designing the structured docs since 2004.
    • Implementing the structured docs since 2006.
  • Hating Structure
    • Filling in the blanks on a Microsoft Word template prevented me from giving the topic the unique treatment that it deserved.
  • Hating Lack of Structure
    • Starting with a blank document prevented me from expanding my influence in the project, the team, and the company.
  • How Structure Makes Life Easier
    • Researching
    • Asking questions in meetings
    • Drafting docs
    • Getting reviews
    • Putting features in perspective
    • Updating docs
    • Writing predictable docs
  • How Structure Makes Life Easier
      • Structuring the documentation can change the way a whole project team thinks about features.
  • 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
  • How Structure Doesn't Make Life Harder
    • Creativity
    • Aesthetics
    • Autonomy
    • Job security
  • Thank You
      • Amanda Cross
      • Structured Writing Evangelist
      • [email_address]
http://www.slideshare.net/abelsp/one-writers-perspective-how-structured-xml-authoring-changes-how-you-work
www.slideshare.net
crawl=CC-MAIN-2014-35
151954
application/http; msgtype=response
sha1:XSMAKHDP2PBZFQ2AYVAK2PIKLVMLZPKE
<urn:uuid:cca7eee3-3127-4ee0-8932-2f317be499af>
2014-08-30T09:37:41Z
216.52.242.112
sha1:FOIVRPWBWPGRNBE7ROZHGN6IYX6TTNVD
<urn:uuid:17bdc10d-9cf4-4436-8919-65c254f35fb7>
http://www.slideshare.net/abelsp/one-writers-perspective-how-structured-xml-authoring-changes-how-you-work
length
response
<urn:uuid:d423b5d8-3cff-4610-807e-ca9604554c9e>
robots: classic
hostname: ip-10-180-136-8.ec2.internal
software: Nutch 1.6 (CC)/CC WarcExport 1.0
isPartOf: CC-MAIN-2014-35
operator: CommonCrawl Admin
description: Wide crawl of the web with URLs provided by Blekko for August 2014
publisher: CommonCrawl
format: WARC File Format 1.0
conformsTo: http://bibnum.bnf.fr/WARC/WARC_ISO_28500_version1_latestdraft.pdf