Writing Reusable Content to Support Content Models

•

0 likes•330 views

The document discusses writing reusable content to support models. It defines content models as documenting the structure of information products, including the components they contain and how they are structured. Structure shows how information products are put together and also refers to how content is written within that structure to ensure consistency. Common structures for information products include providing an overview, features, specifications, and installation procedures, with the specific order depending on the type of document.

Business Technology

Writing Reusable Content to
Support Models

Pamela Kostur
Partner
Parallax Communications

Welcome

Issues with structure

© Parallax Communications 2008

How to resolve issues
Defining structure, identifying reuse
Writing to the structure

© Parallax Communications 2008

What are content models?
Document the structure of your
information products
The components they contain
How components are structured
Where components are used

© Parallax Communications 2008

What is structure?
Shows how information products are
put together
Also refers to how content is written
within that structure
Ensures consistency whoever writes the
information product or a part of it

© Parallax Communications 2008

Writing Reusable Content to Support Content Models

Presented at DocTrain East 2007 Conference by Pamela Kostur, Parallax Communications -- Okay, so you have an information model -- a structure -- but now you have to figure out how to write the content that goes into that structure. How do you write content that will be usable and consistent, regardless of who is writing? This session shows you how to create consistent, reusable content to support your structures, and how to create writing guidelines that all authors can follow.

Writing Reusable Content

Scott Abel

Presented at DocTrain East 2007 Conference by Pamela Kostur, Parallax Communications -- Are you the type of technical communicator who likes to "start from scratch"? Do you hesitate to reuse content that others create because it could never be as good as what you could write yourself? Do you prefer to hoard your perfectly-crafted content to protect your creative genius? If you answered yes to any of these questions, attend this workshop to learn why writing reusable content and why reusing content that others createחare important to your career. You'll see that writing reusable content is more fun and more creative than you might think!

Tips & Tricks to build software architecture document

Karthikeyan VK

Overcoming Product Data challenges in Publishing Organizations Using Oracle P...

Cognizant

Writing for Reuse: Learning How To Write Modular Content for Reuse

Scott Abel

Presented by Pamela Kostur at Documentation and Training West, May 6-9, 2008 in Vancouver, BC Writing modular content that can easily be reused is important not only when working in a content management environment, but also in the world of everyday technical communication. Technical communicators are being called upon more and more to create reusable content and to reuse content that others produce. There are several good reasons to adopt writing for reuse, among them: * Writing for reuse is efficient. It’s costly for several people to create the same product description (or procedure or error message) over and over again. Instead, one person can create it for all uses, based on a standard that accommodates all uses. * Writing for reuse helps to ensure consistency. When the same product description is used for the manual, the online help, and the brochure, you can rest assured it is consistent. * Writing for reuse helps to make content more usable. When writing for reuse, it’s critical that you follow standards, which are based on usability. Standards ensure that similar types of content are structured in similar ways. Everyone writing a product description follows the standard for the product description, making it both reusable and usable. * Writing for reuse helps users to navigate through content. Reusable content is written in modules with clearly defined labels identifying the content’s purpose. Modules can be arranged to accommodate different users and users; the modularity can also help users to easily identify and select the information they need. * Writing for reuse is efficient for you, for the company you work for, and for your users. However, writing for reuse is different than “starting from scratch” or from writing a in the narrative form that many of us have learned and followed for several years. This workshop will convince you of the importance of writing for reuse and show you how to do it!

Dynamic modelling best practice recommendation for the SID

gtilton

Dita webinar 20th marchMetapercept

Togaf introduction and core concepts

Paul Sullivan

Automated application testing for the telecommunication industry using Framew...

TransWare AG

Success Factors for DITA Adoption with XMetaL: Best Practices and FundamentalsScott Abel

Online Togaf 9.1 Training in USA

Xoom Trainings

Togaf is a high level and holistic approach to design, which is typically modeled at four levels: business, application, data, and technology. It tries to give a well-tested overall starting model to information architects, which can then be built upon. It relies heavily on modularization, standardization, and already existing, proven technologies and products. For More Information please follow the below link: http://www.xoomtrainings.com/course/togaf For Togaf 9.1 Online Training Demo Please Find the below link: https://www.youtube.com/watch?v=TF-h6yUc9eo For General Queries Email us at sales@xoomtrainings.com or +1-610-686-8077

Integration strategy for large erp deployments

Arup Dutta

Sample_Data_and_Data_ModulesMichael Cook

Togaf online training

xoomlakshmi

Enterprise Library 3.0 Overview

mcgurk

Max Poliashenko - Enterprise Product Architecture

iasaglobal

Week 2-What is Enterprise Architecure (1).pptx

RizalPrambudi3

PL20876-AU2016Kevin Smedley

Factsheet ea composer-april-2017

eacomposer

Chapter 2 - Enterprise Application Integration.pdf

Khairul Anwar Sedek

2023 Challenges and Opportunities Impacting Technical Documentation Team Capa...

Scott Abel

The Cognitive Era and the Future of Content

Scott Abel

A new era of computing—The Cognitive Era—is taking shape right now. It promises monumental change; altering forever the way we create, manage, and deliver content. Over the next two decades cognitive computing will radically transform every aspect of our field. It will change the way human beings around the globe live and work. It will change the way business solve problems and make decisions. And, it will provide us with powerful methods of enabling customer success. The Cognitive Era is not science fiction. It’s science fact. It’s here today. Let’s explore the possibilities.

Clear and Simple: Lower Your Content Costs with Global English with Matthew K...

Scott Abel

In this webinar, Matt and Greg explain what Global English is and who it benefits, introduce you to some Global English techniques that you can implement immediately, and they examine a couple of case studies of companies who have implemented Global English—and have experienced dramatic results. This session is part of The Content Wrangler Virtual Summit on Advanced Technical Communication Practices, December 4-5, 2014. Hosted by BrightTALK. Sponsored by SDL, Astoria Software, Acrolinx, oXygen XML Editor, Logos, Scriptorium, and Oberon Technologies.

Fandom Isn't Random with Andrew Thomas, SDL

Scott Abel

Andrew Thomas shows you a fast-paced look at how to leverage content to cultivate a loyal customer base. Andrew Thomas is a Director of Product Marketing for Content Management Technologies at SDL, focusing on structured content technologies. Andrew has worked with XML for a wide variety of content, from marketing materials, to printed manuals and web applications. He's witnessed firsthand, the diversity of structured content and how it can empower businesses and customer engagement. Before joining SDL, Andrew was a language intelligence solutions manager for Adobe Systems and oversaw the translation process for their DITA content. This session was part of The Content Wrangler Virtual Summit on Advanced Technical Communication Practices, December 4-5, 2014. Hosted by BrightTALK. Sponsored by SDL, Astoria Software, Acrolinx, oXygen XML Editor, Logos, Scriptorium, and Oberon Technologies.

Deep Dive: Structured XML Authoring with George Bina, oXygen XML Editor

Scott Abel

George Bina explores the world of XML authoring for technical documentation. He shares tips and tricks designed to help technical communicators understand the advanced information management capabilities structured XML authoring provides over traditional authoring approaches. Specifically, George addresses the following questions: How do I know what content to create? What XML markup should I choose and why? How do I leverage markup to engineer better authoring experiences? How to we enforce content rules in XML documents? Why correcting content problems during the authoring process can help you reduce costs? This session was part of The Content Wrangler Virtual Summit on Advanced Technical Communication Practices, December 4-5, 2014. Hosted by BrightTALK. Sponsored by SDL, Astoria Software, Acrolinx, oXygen XML Editor, Logos, Scriptorium, and Oberon Technologies.

The Future of Technical Communication is Marketing

Scott Abel

Once a prospect buys a product or service, the content they interact with is no longer familiar. The instructions provided don't look, feel, or sound anything like the marketing and sales materials that introduced them to your brand. Neither does the service contract, the warranty, the customer support website, the product documentation, nor the training materials. The extensive variability in customer experience — and each customer touchpoint — creates a different and inconsistent version of the brand, some that bear little or no resemblance to the brand that executives believe they are building. There are often as many brands as there are touchpoints. For no good reason, the content experience changes drastically -- and not in a good way. That's why organizations that recognize the importance of a unified customer experience have started rethinking what it means to be customer-centric. Some forward-thinking organizations are reorganizing customer-facing content creators into teams under one roof. They're breaking down the barriers — the silos — that prevent them from collaborating; from creating a unified customer content experience. In this presentation, delivered at Acrolinx Day at LavaCon 2014 Portland, Scott Abel, The Content Wrangler, discussed the challenges of content inconsistency and incongruity, and why he thinks the future of technical communication is marketing.

The Making of 'The Language of Content Strategy' - by Scott Abel, The Content...

Scott Abel

Time is in short supply. Deadlines are tight. Resources are even tighter. If you're like most content professionals, you have dozens of great ideas but not enough time, money or experience to bring them to life. But it doesn't have to be this way. In this content marketing meets intelligent content engineering case study, we will explain how the newly published book, The Language of Content Strategy (XML Press) was created with the help of the crowd, structured XML content, a wiki and a formal content strategy. Attend this session to learn how the two seasoned content strategists enlisted the help of 50 knowledgeable experts to create a printed book, an e-book, a companion website and educational flash cards in record time, all from a single source of content. You'll discover why it's imperative that content professionals —regardless of their area of specialty — understand and leverage the power of advanced information development practices. You'll leave knowing why a repeatable content production system, optimized for productivity and designed to efficiently produce multiple content products simultaneously, is no longer an option, but rather a necessity.

5 Revolutionary Technologies Technical Communicators Can’t Afford To Ignore

Scott Abel

Getting the right information to the right people, at the right time, in the right format, and in the right language is the goal of every professional technical communicator. But, the pace of change is fast, and each and every step forward is often accompanied by two steps back. That’s because the speed of technological change is outstripping our ability to keep up. It seems we’re always playing catch up. But, it doesn’t have to be that way. In this slide deck, Scott Abel, The Content Wrangler, showcases five powerful information technology innovations that, when harnessed by professional technical communicators, can help us future-proof our content and ensure we’re meeting – even exceeding – our goals.

Content Marketing Futurist: Revolutionary Technologies Content Marketers Can’...

Scott Abel

Getting the right information to the right people, at the right time, in the right format, and in the right language is the goal of every professional content marketer. But, the pace of change is fast, and each and every step forward is often accompanied by two steps back. That’s because the speed of technological change is outstripping our ability to keep up. It seems we’re always playing catch up. But, it doesn’t have to be that way. In this Content Marketing World 2014 presentation, Scott Abel, The Content Wrangler, showcases five powerful information technology innovations that, when harnessed by professional content marketers, can help us future-proof our content marketing efforts and ensure we’re meeting – even exceeding – our goals.

Thinking Strategically About Content - Localization World Singapore

Scott Abel

In this presentation from Localization World Singapore, April 2013, Scott Abel explores the importance of thinking strategically about content (how it is created, why its created, and the goals of global content initiatives) by helping the audience understand the importance of vision in content strategy. The presentation also touches on how organizations can find time for innovation and provides several resources for content strategy professionals.

More from Scott Abel (20)

2023 Challenges and Opportunities Impacting Technical Documentation Team Capa...

The Cognitive Era and the Future of Content

The cognitive era and the future of content

Establishing thought leadership with content manufacturing and influencer mar...

Creating A Digital Content Factory: Getting Started with Intelligent Content

Intelligent Content in the Experience Age by Scott Abel, The Content Wrangler

Emerging Trends in Visual Content Marketing with Adam Helweh

Scalable Content Strategy: Nice Thought or Viable Vision? with Colleen Jones

Content Strategy Across Geographies and Platforms with Melinda Flores

The ROI of Intelligent Content with Mark Lewis, DITA Educator, Quark

Content Strategy for Technical Communication and Beyond with Gretyl Kinsey, S...

The Future of Technical Communication is Marketing with Scott Abel, The Conte...

Clear and Simple: Lower Your Content Costs with Global English with Matthew K...

Fandom Isn't Random with Andrew Thomas, SDL

Deep Dive: Structured XML Authoring with George Bina, oXygen XML Editor

The Future of Technical Communication is Marketing

The Making of 'The Language of Content Strategy' - by Scott Abel, The Content...

5 Revolutionary Technologies Technical Communicators Can’t Afford To Ignore

Content Marketing Futurist: Revolutionary Technologies Content Marketers Can’...

Thinking Strategically About Content - Localization World Singapore

Recently uploaded

Call 8867766396 Satta Matka Dpboss Matka Guessing Satta batta Matka 420 Satta...

bosssp10

The Influence of Marketing Strategy and Market Competition on Business Perfor...

Adam Smith

The effects of customers service quality and online reviews on customer loyal...

balatucanapplelovely

Recruiting in the Digital Age: A Social Media Masterclass

LuanWise

Digital Transformation and IT Strategy Toolkit and Templates

Aurelien Domont, MBA

This Digital Transformation and IT Strategy Toolkit was created by ex-McKinsey, Deloitte and BCG Management Consultants, after more than 5,000 hours of work. It is considered the world's best & most comprehensive Digital Transformation and IT Strategy Toolkit. It includes all the Frameworks, Best Practices & Templates required to successfully undertake the Digital Transformation of your organization and define a robust IT Strategy. Editable Toolkit to help you reuse our content: 700 Powerpoint slides | 35 Excel sheets | 84 minutes of Video training This PowerPoint presentation is only a small preview of our Toolkits. For more details, visit www.domontconsulting.com

Event Report - SAP Sapphire 2024 Orlando - lots of innovation and old challenges

Holger Mueller

BeMetals Investor Presentation_June 1, 2024.pdf

DerekIwanaka1

Observation Lab PowerPoint Assignment for TEM 431

ecamare2

Authentically Social by Corey Perlman - EO Puerto Rico

Corey Perlman, Social Media Speaker and Consultant

Premium MEAN Stack Development Solutions for Modern Businesses

SynapseIndia

ModelingMarketingStrategiesMKS.CollumbiaUniversitypdf

fisherameliaisabella

Top mailing list providers in the USA.pptx

JeremyPeirce1

ikea_woodgreen_petscharity_cat-alogue_digital.pdf

agatadrynko

Helen Lubchak: Тренди в управлінні проєктами та miltech (UA)

Lviv Startup Club

Authentically Social Presented by Corey Perlman

Corey Perlman, Social Media Speaker and Consultant

Anny Serafina Love - Letter of Recommendation by Kellen Harkins, MS.

AnnySerafinaLove

Best Forex Brokers Comparison in INDIA 2024

Top Forex Brokers Review

Navigating the world of forex trading can be challenging, especially for beginners. To help you make an informed decision, we have comprehensively compared the best forex brokers in India for 2024. This article, reviewed by Top Forex Brokers Review, will cover featured award winners, the best forex brokers, featured offers, the best copy trading platforms, the best forex brokers for beginners, the best MetaTrader brokers, and recently updated reviews. We will focus on FP Markets, Black Bull, EightCap, IC Markets, and Octa.

Exploring Patterns of Connection with Social Dreaming

Nicola Wreford-Howard

Creative Web Design Company in Singapore

techboxsqauremedia

Meas_Dylan_DMBS_PB1_2024-05XX_Revised.pdf

dylandmeas

Recently uploaded (20)

Call 8867766396 Satta Matka Dpboss Matka Guessing Satta batta Matka 420 Satta...

The Influence of Marketing Strategy and Market Competition on Business Perfor...

The effects of customers service quality and online reviews on customer loyal...

Recruiting in the Digital Age: A Social Media Masterclass

Digital Transformation and IT Strategy Toolkit and Templates

Event Report - SAP Sapphire 2024 Orlando - lots of innovation and old challenges

BeMetals Investor Presentation_June 1, 2024.pdf

Observation Lab PowerPoint Assignment for TEM 431

Authentically Social by Corey Perlman - EO Puerto Rico

Premium MEAN Stack Development Solutions for Modern Businesses

ModelingMarketingStrategiesMKS.CollumbiaUniversitypdf

Top mailing list providers in the USA.pptx

ikea_woodgreen_petscharity_cat-alogue_digital.pdf

Helen Lubchak: Тренди в управлінні проєктами та miltech (UA)

Authentically Social Presented by Corey Perlman

Anny Serafina Love - Letter of Recommendation by Kellen Harkins, MS.

Best Forex Brokers Comparison in INDIA 2024

Exploring Patterns of Connection with Social Dreaming

Creative Web Design Company in Singapore

Meas_Dylan_DMBS_PB1_2024-05XX_Revised.pdf