This session, targeted at decision makers, consultants, and information professionals, introduces the concepts behind structured content and discusses the benefits and challenges to adoption.
Production planning & control - descriptive type question module -wise for upcoming Mumbai university exam - Mechanical Engineering - Learn with GeekAlign
INVENTORY MANAGEMENT:
What is inventory?
Why do we care for inventory?
What do you consider regarding inventory?
Cost of inventory
Benefits of inventory
Modelling inventory in supply chain
Types of inventory models
Production planning & control - descriptive type question module -wise for upcoming Mumbai university exam - Mechanical Engineering - Learn with GeekAlign
INVENTORY MANAGEMENT:
What is inventory?
Why do we care for inventory?
What do you consider regarding inventory?
Cost of inventory
Benefits of inventory
Modelling inventory in supply chain
Types of inventory models
Content Engineering and The Internet of “Smart” Thingsdclsocialmedia
The Smart Ass™ Fan is the latest ceiling fan from Big Ass Fans®. Smart products are everywhere now, and they’re connected. Imagine a family of smart products and how much content could be/should be shared. These products can include mechanical, electrical and software parts AND content.
How will you deal with this explosive content requirement? This webinar takes a tour of the problem and explains what content engineering is …and how it can be used to create a sustainable content life cycle. Smart products need smart content.
Converting and Integrating Legacy Data and Documents When Implementing a New CMSdclsocialmedia
If you are in the Insurance and Financial industries, attend this webinar and learn the roadmap for implementing a content management system with a customized conversion process.
DITA for Small Teams: An Open Source Approach to DITA Content Managementdclsocialmedia
Eliot Kimbler describes a general approach to using common and easily-available open-source tools to provision an authoring and production support system suitable for small teams of authors.
Is Your Enterprise “fire-fighting” translation issues? Optimize the process w...dclsocialmedia
Join Scott Carothers, Senior Globalization Executive at Kinetic the Technology Agency for an overview of specific translation metrics that will assist your enterprise in optimizing the translation process, and assist you in leading your organization as an advocate of continual process improvement.
Managing Deliverable-Specific Link Anchors: New Suggested Best Practice for Keysdclsocialmedia
This webinar presents a general approach that uses keys on navigation topicrefs to determine the anchors in deliverables, giving more control to map authors and removing dependencies on the behaviors of specific deliverable generation systems. This way of using keys also addresses challenges inherent in doing cross referencing within a single publication when topics are used multiple times in the map.
In this DCL Webinar, long-time DITA champion Don Day will talk about the basic principles of lightweight structured authoring and the current work of the OASIS Lightweight DITA Subcommittee along those lines. And since this is a work in progress, Don will lay out some practical steps you can take today to start taking advantage of some of these principles as we anticipate the Subcommittee's eventual recommendations.
In this webinar, I will showcase scenarios in which content analysis and design were more collaborative endeavors, and advocate for getting designers and content experts in conversation early on. The result is a better product and less stressful releases.
Attend this webinar as DCL & Comtech Services review the results of the 2016 Industry Trends survey. Learn innovative approaches to development/delivery and more.
Minimalism Revisited — Let’s Stop Developing Content that No One Wantsdclsocialmedia
Dr. JoAnn Hackos, Comtech President and Director of the Center for Information-Development Management (CIDM), demonstrates how using a minimalist approach in developing content is more relevant today than ever before. Busy customers simply want simple help on performing a task and getting a job done. Learn what minimalism really feels like. Learn about designing minimalist information that gets your customers coming back for more.
Attend this session and explore the unseen world of metadata. Learn essential concepts about metadata and taxonomies used to organize metadata. Discuss the role standards play in the design of metadata and controlled vocabularies. Start to formulate strategies and tactics to take control of your metadata.
10 Mistakes When Moving to Topic-Based Authoringdclsocialmedia
But moving to topic-based authoring can be one of the most expensive things you've ever done. In this talk, Sharon Burton will show you the top 10 mistakes made by companies and how you can avoid them. These mistakes can include missing deadlines, delivering poor quality content, or not integrating this content development strategy into the rest of the product development strategy.
Content Conversion Done Right Saves More Than Moneydclsocialmedia
Can you significantly reduce your conversion costs – by 25% or more – without sacrificing quality? The answer is a resounding yes, and this webinar will review the proven methods and best practices for achieving that goal.
Precision Content™ Tools, Techniques, and Technologydclsocialmedia
This webinar will explore fundamental principles for writing and structuring content for the enterprise. Attendees will learn how to approach information typing for structured authoring for more concise and reusable content.
This session will specifically address the analysis phase including considerations such as where the inconsistencies lie, how the content is currently being reused or not, how translation services are applied as a measure of quality, what channels does the content need to support, what issues each channel may have in using the content, does task-based authoring make sense and more in order to achieve the maximum ROI.
Pradeep Jain - Smart Procedures at the US Department of DefenseLavaConConference
Nobody knows paperwork like the Pentagon. Without exaggeration, the Department of Defense (DoD) has policies and procedures for writing policies and procedures.
In this session attendees will learn:
How to enable smart policies and procedures
How to use intelligent content to streamline complex documentation processes
How to simplify the technology requirements for XML-based documentation processes
How to integrate intelligent content into a mainstream enterprise technology landscape
How to make XML based solutions scalable & sustainable
https://ictect1-my.sharepoint.com/:f:/g/personal/pradeep_jain_ictect_com/EjMvtc9mwBpNscLIvSicvv0BcW3tIfqRhhoEZ-SbWvTYvA?e=4erftn
Content Engineering and The Internet of “Smart” Thingsdclsocialmedia
The Smart Ass™ Fan is the latest ceiling fan from Big Ass Fans®. Smart products are everywhere now, and they’re connected. Imagine a family of smart products and how much content could be/should be shared. These products can include mechanical, electrical and software parts AND content.
How will you deal with this explosive content requirement? This webinar takes a tour of the problem and explains what content engineering is …and how it can be used to create a sustainable content life cycle. Smart products need smart content.
Converting and Integrating Legacy Data and Documents When Implementing a New CMSdclsocialmedia
If you are in the Insurance and Financial industries, attend this webinar and learn the roadmap for implementing a content management system with a customized conversion process.
DITA for Small Teams: An Open Source Approach to DITA Content Managementdclsocialmedia
Eliot Kimbler describes a general approach to using common and easily-available open-source tools to provision an authoring and production support system suitable for small teams of authors.
Is Your Enterprise “fire-fighting” translation issues? Optimize the process w...dclsocialmedia
Join Scott Carothers, Senior Globalization Executive at Kinetic the Technology Agency for an overview of specific translation metrics that will assist your enterprise in optimizing the translation process, and assist you in leading your organization as an advocate of continual process improvement.
Managing Deliverable-Specific Link Anchors: New Suggested Best Practice for Keysdclsocialmedia
This webinar presents a general approach that uses keys on navigation topicrefs to determine the anchors in deliverables, giving more control to map authors and removing dependencies on the behaviors of specific deliverable generation systems. This way of using keys also addresses challenges inherent in doing cross referencing within a single publication when topics are used multiple times in the map.
In this DCL Webinar, long-time DITA champion Don Day will talk about the basic principles of lightweight structured authoring and the current work of the OASIS Lightweight DITA Subcommittee along those lines. And since this is a work in progress, Don will lay out some practical steps you can take today to start taking advantage of some of these principles as we anticipate the Subcommittee's eventual recommendations.
In this webinar, I will showcase scenarios in which content analysis and design were more collaborative endeavors, and advocate for getting designers and content experts in conversation early on. The result is a better product and less stressful releases.
Attend this webinar as DCL & Comtech Services review the results of the 2016 Industry Trends survey. Learn innovative approaches to development/delivery and more.
Minimalism Revisited — Let’s Stop Developing Content that No One Wantsdclsocialmedia
Dr. JoAnn Hackos, Comtech President and Director of the Center for Information-Development Management (CIDM), demonstrates how using a minimalist approach in developing content is more relevant today than ever before. Busy customers simply want simple help on performing a task and getting a job done. Learn what minimalism really feels like. Learn about designing minimalist information that gets your customers coming back for more.
Attend this session and explore the unseen world of metadata. Learn essential concepts about metadata and taxonomies used to organize metadata. Discuss the role standards play in the design of metadata and controlled vocabularies. Start to formulate strategies and tactics to take control of your metadata.
10 Mistakes When Moving to Topic-Based Authoringdclsocialmedia
But moving to topic-based authoring can be one of the most expensive things you've ever done. In this talk, Sharon Burton will show you the top 10 mistakes made by companies and how you can avoid them. These mistakes can include missing deadlines, delivering poor quality content, or not integrating this content development strategy into the rest of the product development strategy.
Content Conversion Done Right Saves More Than Moneydclsocialmedia
Can you significantly reduce your conversion costs – by 25% or more – without sacrificing quality? The answer is a resounding yes, and this webinar will review the proven methods and best practices for achieving that goal.
Precision Content™ Tools, Techniques, and Technologydclsocialmedia
This webinar will explore fundamental principles for writing and structuring content for the enterprise. Attendees will learn how to approach information typing for structured authoring for more concise and reusable content.
This session will specifically address the analysis phase including considerations such as where the inconsistencies lie, how the content is currently being reused or not, how translation services are applied as a measure of quality, what channels does the content need to support, what issues each channel may have in using the content, does task-based authoring make sense and more in order to achieve the maximum ROI.
Pradeep Jain - Smart Procedures at the US Department of DefenseLavaConConference
Nobody knows paperwork like the Pentagon. Without exaggeration, the Department of Defense (DoD) has policies and procedures for writing policies and procedures.
In this session attendees will learn:
How to enable smart policies and procedures
How to use intelligent content to streamline complex documentation processes
How to simplify the technology requirements for XML-based documentation processes
How to integrate intelligent content into a mainstream enterprise technology landscape
How to make XML based solutions scalable & sustainable
https://ictect1-my.sharepoint.com/:f:/g/personal/pradeep_jain_ictect_com/EjMvtc9mwBpNscLIvSicvv0BcW3tIfqRhhoEZ-SbWvTYvA?e=4erftn
10 Million Dita Topics Can't Be Wrong, December 6th, 2016, Webinar by Keith Schengili-Roberts, IXIASOFT DITA Specialist, Hosted by Scott Abel at The Content Wrangler Virtual Summit
DITA Quick Start Webinar Series: Building a Project PlanSuite Solutions
Presenters: Joe Gelb, President, Suite Solutions and Yehudit Lindblom, Project Manager, Suite Solutions
Abstract:
Migrating to DITA XML-based authoring and publishing promises rich rewards in terms of lower costs and faster time to publication. But DITA migration also requires a well-planned process that will lead you through all the steps of a successful implementation. In this webinar, experienced project manager Yehudit Lindblom and Joe Gelb will review a process that covers all the bases, helping you build your game plan for a winning DITA implementation.
Visit us at http://www.suite-sol.com
Follow us on LinkedIn http://www.linkedin.com/company/527916
Workshop - Ways of Working Within the M365 Workspace.pptxSimon Rawson
This is an in-depth walkthrough of Microsoft 365 information architecture. It includes:
* Ways into M365 - Teams, SharePoint and Viva Connections
* Elements of information architecture in M365
* M365 governance
* Classification, security and retention models and the role they play in enterprise search
Session at tcworld 2016. Organized by Kristen James Eberlein (Eberlein Consulting LLC); other participants were Joe Gollner (Gnostyx), George Bina (SyncroSoft), Jean-François Ameye (IXIASOFT), and Eliot Kimber (Contrext).
DITA Quick Start: System Architecture of a Basic DITA ToolsetSuite Solutions
Presenter: Joe Gelb, President, Suite Solutions
Abstract: In this webinar, you will learn about the software, integration and customization which enable you to effectively author, manage, localize, publish and share your DITA XML content. We will review how each tool fits into the content lifecycle and discuss options for an incremental DITA XML implementation using a basic toolset as the starting point.
Connecting Intelligent Content with Micropublishing and BeyondDon Day
This presentation will describe and demonstrate a grand unified vision for pulling together different kinds of single-page products for the Web, for print, and more. Lessons from this model can give you an edge in market-leading adoption of the next great thing after micropublishing, the current trend.
The main focus of my talk is how DITA works well in an Agile environment for technical publication to produce simple, crisp, and lean user documentation per sprint. Just as programmers employ Agile techniques to improve their deliverables, task-oriented documentation using DITA helps technical writers in creating user deliverables that allows for continuous feedback and improve the documentation’s velocity and adaptability to change, even extreme changes.
DITA Quick Start Webinar: Defining Your Style Sheet RequirementsSuite Solutions
Your DITA implementation is under way, and promises higher content reusability with shorter time to publication. A key aspect of your implementation is automated multi-channel publishing of your content to a variety of outputs: PDF, HTML, online help, mobile, dynamic web, eLearning and more. In this webinar, expert project manager Yehudit Lindblom and Suite Solutions President Joe Gelb go beyond formatting requirements to review best practices that help you cover all the bases for smooth implementation and easy maintenance of your dynamic publishing customizations.
Learn more about DITA Quick Start http://www.suite-sol.com/pages/solutions/dita-quick-start.html
Follow us on LinkedIn http://www.linkedin.com/company/527916
Similar to Introduction to Structured Authoring (20)
This webinar provides an update on the current status of the DITA for Publishers. EPUB and HTML5 transforms and their support for EPUB3, HTML5, and the implications of new features in DITA 1.3.
Automating Complex High-Volume Technical Paper and Journal Article Page Compo...dclsocialmedia
SAE International is a global association of more than 138,000 engineers and related technical experts in the aerospace, automotive and commercial-vehicle industries. Annually, SAE organizes and manages an industry conference, its World Congress and Exhibition, where thousands of technical papers and journal articles are presented as part of the conference program. Leading up to the Word Congress, the technical papers and journal articles are reviewed for compliance to SAE publishing requirements and published for print and made available online in a very short time-frame. This paper describes how SAE evolved the production cycle from a less than efficient XSL-FO based process to a highly automated process leveraging NLM XML, XSLT and Adobe InDesign resulting in productivity gains and higher quality output. This paper will take you through the evolution of this project and talk to future enhancements aimed at driving additional benefits.
If everyone write their documents with the intent that they be standardized and converted, conversion to S1000D would be easy. But the reality is that most legacy data lacks the details needed for a full conversion or contains anomalies and irrelevant text. This leads us to the question one must ask: should I convert, rewrite, or manually convert the legacy data? In this presentation, we will attempt to answer this question by reviewing:
o A very quick introduction to S1000D conversions
o What the technical headaches are
o Whether to convert or rewrite
o Planning for a good conversion experience
o What the timeline looks like
o Some tools to help
Marketing and Strategy and Bears... oh my!dclsocialmedia
It's a big scary world out there, filled with content strategists, content marketers, content creators, content managers... it never ends! In this talk, we'll talk about the care and feeding of a content whatever, and answer the question: why does it matter what we call ourselves?
New Directions 2015 – Changes in Content Best Practicesdclsocialmedia
The Center for Information-Development Management (CIDM) and Data Conversion Laboratories (DCL) announce the results of our 2015 Industry Trends Survey. Comparisons with these surveys in previous years provides you with a comprehensive view of what is the same and what is changing in technical information best practices.
Managing Documentation Projects in Nearly Any Environmentdclsocialmedia
Your documentation projects need to be successful. Success doesn't happen accidentally, it happens from planning and managing. And in the 21st Century, the ways to plan and manage projects is changing. We have to change, too.
DevOps and Testing slides at DASA ConnectKari Kakkonen
My and Rik Marselis slides at 30.5.2024 DASA Connect conference. We discuss about what is testing, then what is agile testing and finally what is Testing in DevOps. Finally we had lovely workshop with the participants trying to find out different ways to think about quality and testing in different parts of the DevOps infinity loop.
Accelerate your Kubernetes clusters with Varnish CachingThijs Feryn
A presentation about the usage and availability of Varnish on Kubernetes. This talk explores the capabilities of Varnish caching and shows how to use the Varnish Helm chart to deploy it to Kubernetes.
This presentation was delivered at K8SUG Singapore. See https://feryn.eu/presentations/accelerate-your-kubernetes-clusters-with-varnish-caching-k8sug-singapore-28-2024 for more details.
Kubernetes & AI - Beauty and the Beast !?! @KCD Istanbul 2024Tobias Schneck
As AI technology is pushing into IT I was wondering myself, as an “infrastructure container kubernetes guy”, how get this fancy AI technology get managed from an infrastructure operational view? Is it possible to apply our lovely cloud native principals as well? What benefit’s both technologies could bring to each other?
Let me take this questions and provide you a short journey through existing deployment models and use cases for AI software. On practical examples, we discuss what cloud/on-premise strategy we may need for applying it to our own infrastructure to get it to work from an enterprise perspective. I want to give an overview about infrastructure requirements and technologies, what could be beneficial or limiting your AI use cases in an enterprise environment. An interactive Demo will give you some insides, what approaches I got already working for real.
State of ICS and IoT Cyber Threat Landscape Report 2024 previewPrayukth K V
The IoT and OT threat landscape report has been prepared by the Threat Research Team at Sectrio using data from Sectrio, cyber threat intelligence farming facilities spread across over 85 cities around the world. In addition, Sectrio also runs AI-based advanced threat and payload engagement facilities that serve as sinks to attract and engage sophisticated threat actors, and newer malware including new variants and latent threats that are at an earlier stage of development.
The latest edition of the OT/ICS and IoT security Threat Landscape Report 2024 also covers:
State of global ICS asset and network exposure
Sectoral targets and attacks as well as the cost of ransom
Global APT activity, AI usage, actor and tactic profiles, and implications
Rise in volumes of AI-powered cyberattacks
Major cyber events in 2024
Malware and malicious payload trends
Cyberattack types and targets
Vulnerability exploit attempts on CVEs
Attacks on counties – USA
Expansion of bot farms – how, where, and why
In-depth analysis of the cyber threat landscape across North America, South America, Europe, APAC, and the Middle East
Why are attacks on smart factories rising?
Cyber risk predictions
Axis of attacks – Europe
Systemic attacks in the Middle East
Download the full report from here:
https://sectrio.com/resources/ot-threat-landscape-reports/sectrio-releases-ot-ics-and-iot-security-threat-landscape-report-2024/
GDG Cloud Southlake #33: Boule & Rebala: Effective AppSec in SDLC using Deplo...James Anderson
Effective Application Security in Software Delivery lifecycle using Deployment Firewall and DBOM
The modern software delivery process (or the CI/CD process) includes many tools, distributed teams, open-source code, and cloud platforms. Constant focus on speed to release software to market, along with the traditional slow and manual security checks has caused gaps in continuous security as an important piece in the software supply chain. Today organizations feel more susceptible to external and internal cyber threats due to the vast attack surface in their applications supply chain and the lack of end-to-end governance and risk management.
The software team must secure its software delivery process to avoid vulnerability and security breaches. This needs to be achieved with existing tool chains and without extensive rework of the delivery processes. This talk will present strategies and techniques for providing visibility into the true risk of the existing vulnerabilities, preventing the introduction of security issues in the software, resolving vulnerabilities in production environments quickly, and capturing the deployment bill of materials (DBOM).
Speakers:
Bob Boule
Robert Boule is a technology enthusiast with PASSION for technology and making things work along with a knack for helping others understand how things work. He comes with around 20 years of solution engineering experience in application security, software continuous delivery, and SaaS platforms. He is known for his dynamic presentations in CI/CD and application security integrated in software delivery lifecycle.
Gopinath Rebala
Gopinath Rebala is the CTO of OpsMx, where he has overall responsibility for the machine learning and data processing architectures for Secure Software Delivery. Gopi also has a strong connection with our customers, leading design and architecture for strategic implementations. Gopi is a frequent speaker and well-known leader in continuous delivery and integrating security into software delivery.
Software Delivery At the Speed of AI: Inflectra Invests In AI-Powered QualityInflectra
In this insightful webinar, Inflectra explores how artificial intelligence (AI) is transforming software development and testing. Discover how AI-powered tools are revolutionizing every stage of the software development lifecycle (SDLC), from design and prototyping to testing, deployment, and monitoring.
Learn about:
• The Future of Testing: How AI is shifting testing towards verification, analysis, and higher-level skills, while reducing repetitive tasks.
• Test Automation: How AI-powered test case generation, optimization, and self-healing tests are making testing more efficient and effective.
• Visual Testing: Explore the emerging capabilities of AI in visual testing and how it's set to revolutionize UI verification.
• Inflectra's AI Solutions: See demonstrations of Inflectra's cutting-edge AI tools like the ChatGPT plugin and Azure Open AI platform, designed to streamline your testing process.
Whether you're a developer, tester, or QA professional, this webinar will give you valuable insights into how AI is shaping the future of software delivery.
Neuro-symbolic is not enough, we need neuro-*semantic*Frank van Harmelen
Neuro-symbolic (NeSy) AI is on the rise. However, simply machine learning on just any symbolic structure is not sufficient to really harvest the gains of NeSy. These will only be gained when the symbolic structures have an actual semantics. I give an operational definition of semantics as “predictable inference”.
All of this illustrated with link prediction over knowledge graphs, but the argument is general.
2. Confidential & Proprietarywww.dclab.com 2
Valuable Content Transformed
• Document Digitization
• XML and HTML Conversion
• eBook Production
• Hosted Solutions
• Big Data Automation
• Conversion Management
• Editorial Services
• Harmonizer
3. Confidential & Proprietarywww.dclab.com 3
Experience the DCL Difference
DCL blends years of conversion experience with cutting-edge technology and the
infrastructure to make the process easy and efficient.
• World-Class Services
• Leading-Edge Technology
• Unparalleled Infrastructure
• US-Based Management
• Complex-Content Expertise
• 24/7 Online Project Tracking
• Automated Quality Control
• Global Capabilities
5. Confidential & Proprietarywww.dclab.com 5
. . . Spanning All Industries
• Aerospace
• Associations
• Defense
• Distribution
• Education
• Financial
• Government
• Libraries
• Life Sciences
• Manufacturing
• Medical
• Museums
• Periodicals
• Professional
• Publishing
• Reference
• Research
• Societies
• Software
• STM
• Technology
• Telecommunications
• Universities
• Utilities
6. About your presenter
6
• Rob Hanna, ECMs
• President of Precision Content Authoring
Solutions Inc. and a director of AIIM First
Canadian Chapter
• Expert in structured authoring and content
management practices and technology
• Instructor at the University of Toronto School
of Continuing Studies – Metadata and
Controlled Vocabularies
10. Importance of
Content Strategy
Before any technology is
considered, organizations must first
consider their content strategy to
fully understand what they need
and how they are going to get
there.
Several factors must be examined.
@2015PrecisionContentAuthoringSolutionsInc.
12. Do we have a problem that needs
solving?
• 5,900,000,000 google searches per
day (who did we ask these questions
to before Google?)
• 540,000 word in the English
language – 5 times more than in
Shakespeare’s time
• 90% of the world’s data has been
generated in the last 2 years
In the year … Human knowledge doubled …
1900 100 years
1945 25 years
2014 13 months
2020 12 hours
13. Structured authoring defined
• structured authoring means a standardised, methodological
approach to content creation incorporating
• systematic labelling
• modular, topic-based architecture
• constrained writing environments, and
• the separation of content and form.
14. Benefits of structured authoring
• Improved
• Collaboration
• Usability
• Consistency, and
• Publishing capabilities.
15. Meeting 2 sets of fundamental needs
The Human Brain
Technology
Find
Understand
Use, and
Retain
Integrate
Search
Process, and
Reuse
Well-structured content helps
16. Early days in structured authoring
• 1997 GML
• Documentation process long and
fraught with opportunities for
human error
• Parsed GML into Access
• Created taxonomies
• Integrated structured data
• Output to HTML (.chm)
19. Language Arts
Language Arts for Personal Response
(LAFPR)
• To emotionally engage the
reader
• Techniques:
• narrative style
• varied vocabulary & sentence
structure
• withholding information
• Writer driven
• Meant to be READ
Language Arts for Information (LAFI)
• To convey information that
readers need to use
• Techniques:
• consistent modular structure
• concise, direct vocabulary
• use of graphics
• Reader driven
• Meant to be USED
21. Ikea Instructions: LAFPR
• If novelist Michael Ondaatje wrote Ikea instructions ….
“The eel-shaped talisman squirms inside the raspy recycled box. A
series of quarter turns – clock hands marking time – bonds back to
base. An alphabet of connections in English and French. A into groove
B. C slots into D. Chipboard credenza communicating Swedish
hegemony.”
• Author/parodist: Geoff Thomas
Globe & Mail, August 27, 2009
22. What is Topic-Based Authoring?
“Topic-based authoring is a modular content creation
approach…”
“A topic is a discrete piece of content that is about a specific
subject, has an identifiable purpose, and can stand alone…”
http://en.wikipedia.org/wiki/Topic-based_authoring
23. Topic-Based Architecture
• Topics are standardized units of information based upon information
type
• Topics require only navigational reference for context and can be read
in any order
• Topics must all contain a descriptive title and normally include a body
and metadata section
• Topics represent a single unit of work for authors
24. Opportunities for Topic-Based Authoring
• Speed to market
• Reduced maintenance effort
• Better opportunities for reuse
• Balancing workload
• Finer control over project management
• Opportunities for collaboration
• Clearer, more concise minimalist content
25. Challenges for Topic-Based Authoring
• Writing process requires greater discipline
• Loss of content ownership for authors
• Less control over look and feel
• Responsibilities redefined
• Loss of context for SMEs and authors
• More to manage
29. Working definitions
Single-sourcing is any process used to systematically
create information products from a single defined
source of information.
or
“Writing information once
and using it many times”
- Ann Rockley, 2001
31. Single-sourcing technology
Single-sourcing is a methodology, not a technology. Although the
software tools associated with single-sourcing are complex, it is the
modular writing, not technology, that ultimately determines the
success of your single-sourcing project.
• Kurt Ament – Single Sourcing: Building Modular Documentation, 2003
32. Can single-sourcing help?
• Single-sourcing will…
• Improve the consistency of information
• Save on maintenance and customization efforts
• Improve the quality of the content
• Require significant upfront planning and investment
33. Return on investment (ROI)
• Expect return on investment if…
• The document is deliverable to clients or is tied directly to a product or
service
• The document has a long life expectancy
• Many updates can be expected over time
• Several variants may exist at any one time
• Parts of the document are reused elsewhere
• I can expect to recover my actual costs
34. Planning and process
• Defining your objectives
• Analysing your audience
• Defining your source and structure
36. What are our objectives?
• Key objectives include:
• Produce a résumé that is easy to update and tailor for each new job
application.
• Maintain various versions: Short/Long; Technical Writer/Team Lead;
Contractor/Employee.
• Maintain various formats including: Word, HTML, PDF, and ASCII text.
• Showcase help authoring skills by producing a Windows help version.
37. Who is my audience
• HR Department
• Placement Agency
• Hiring Manager
• Automated systems
38. Selecting a source
• Does a source already exist?
• Do multiple sources exist?
• How will you resolve discrepancies between various sources?
• Create your definitive source of information
39. Resume structure
• Resume title
• Objective
• Target 1
• Target 2
• Personal Profile
• Education
• School
• Location
• Date
• Degree
• Professional Experience
• Company
• Location
• Position
• Tasks
• Accomplishments
• Skills
• Skill name
• Experience level
• Last used
• Years used
• References
• Name
• Position
• Company
• Contact
• E-mail
• Telephone
• Description
41. Single-sourcing with MS Word
• Ball & Chain
vs. single-
sourcing
Linda Chung
Senior Technical Writer
123 Que en St E
Toronto, ONM4N 3R8
Tel 416 555-1212
Email: linda.chung @lascan .ca
Towrite t wice as m uch docu mentatio n in half
the time.
Really Bi g Corp
Oct 99 - Present
Helped d evelop a single sou rcing pro ject that
lorem ipsum ad ve lor.
Small En terprises
June 98 - Sep 99
Lorem ip sumad v elor dolot.
Objective
Experience
Small En terprises
June 98 - Sep 99
Lorem ip sumad v elor dolot.
Doc 1
.pdf
Doc 2
.hlp
Doc 3
.doc
Object d
Object a
Object b
Object c
1 ton
Data Source
Workflow
42. Single-sourcing with FrameMaker
• Consistency is required for
good output
• Consistent style of writing
• Consistent mark-up of conditions
• FrameMaker limitations
• Conditions for multiple purposes
• Text tagged with multiple
conditions
• Cannot use conditional text to
rearrange your content
44. What is XML?
• (eXtensible Markup Language) is an open
standard for the exchange of information
• first published in 1998 by W3C
• to encode electronic documents readable by
• human, and
• machine
• for a multitude of applications ranging from
• corporate financial reporting applications, to
• Microsoft Word
45. XML is Everywhere
XML defines meaningful data structures for documents
and data. It is a human-readable file format used to
power
• manufacturing assembly lines
• medical devices
• military applications, and
• many other things.
XML is the language of the Web. It enables smart
phones and web browsers.
45
46. What are markup languages?
• pre-date desktop publishing and the Internet
• tell computers how to handle data
• such as how to render electronic content on a page
• categorized as either
• presentation, or
• semantic markup
47. Document Content As We Know It
The contents of a
document are
opaque to the
computer…
So we have to
label them!
Set up the writer’s name as a variable in Oxygen Author
Comments in documents should always be attributed to the reviewer. Oxygen will
insert the writer’s name into draft comments automatically once it is configured
properly.
Before you begin
Ensure that the Precision Content framework is installed on your version of Oxygen
Author.
Procedure
The following steps will guide you through the setup of a custom user variable in
your Oxygen environment.
1. Open Oxygen Author
2. Select Options > Preferences > Custom Editor Variables
3. Click New
4. Enter the appropriate values to create a new custom variable
• Name: prec_d_mapper
• Value: {Your Name}
• Description: Writer name
5. Click OK
48. Presentation markup
• With electronic presentation markup, we markup the
paragraph and italicize the citation for publication
• This is typical of web pages using hypertext markup (HTML)
The Cancer Journal: The Journal of Principles & Practice of
Oncology provides an integrated view of modern oncology across
all disciplines.
<p><i>The Cancer Journal: The Journal of Principles & Practice
of Oncology</i> provides an integrated view of modern oncology
across <i>all</i> disciplines.</p>
The Cancer Journal: The Journal of Principles & Practice of Oncology
provides an integrated view of modern oncology across all disciplines.
49. Enter Structured XML
Getting
better…
<topic><title>Set up the writer’s name as a variable in Oxygen
Author</title>
<shortdesc>Comments in documents should always be attributed to the reviewer. Oxygen will
insert the writer’s name into draft comments automatically once it is configured
properly.</shortdesc>
<body><section><title>Before you begin</title>
<p>Ensure that the Precision Content framework is installed on your version of Oxygen
Author.</p></section>
<section><title>Procedure</title>
<p>The following steps will guide you through the setup of a custom user variable in your Oxygen
environment.<ol>
<li>Open Oxygen Author</li>
<li>Select Options > Preferences > Custom Editor Variables</li>
<li>Click <b>New</b></li>
<li>Enter the appropriate values to create a new custom variable
<lines>Name: prec_d_mapper
Value: <i>{Your Name}</i>
Description: Writer name</lines></li>
<li>Click <b>OK</b></li></ol></p></body></topic>
50. Semantic markup
• With semantic markup, we markup the content to describe the
meaning of the text
• Publishing stylesheets interpret the meaning from the markup
and apply appropriate styles specific to the publishing context
The Cancer Journal: The Journal of Principles & Practice of
Oncology provides an integrated view of modern oncology across
all disciplines.
<intro><cite>The Cancer Journal: The Journal of Principles &
Practice of Oncology</cite> provides an integrated view of
modern oncology across <em>all</em> disciplines.</intro>
The Cancer Journal: The Journal of Principles & Practice of Oncology
provides an integrated view of modern oncology across all disciplines.
The Cancer Journal: The Journal of Principles & Practice of Oncology
provides an integrated view of modern oncology across all disciplines.
51. Enter Structured Semantic XML
Structure
and
Meaning!
Enable
access!
<task><title>Set up the writer’s name as a variable in Oxygen Author</title>
<shortdesc>Comments in documents should always be attributed to the reviewer. Oxygen will
insert the writer’s name into draft comments automatically once it is configured properly.</shortdesc>
<taskbody><prereq><p>Ensure that the Precision Content framework is installed on your
version of Oxygen Author.</p></prereq>
<steps><stepsection>The following steps will guide you through the setup of a custom user
variable in your Oxygen environment.</stepsection>
<step><cmd>Open Oxygen Author</cmd></step>
<step><cmd>Select
<menucascade><uicontrol>Options</uicontrol><uicontrol>Preferences</uicontrol><uicontr
ol>Custom Editor Variables</uicontrol></menucascade></cmd></step>
<step><cmd>Click <uicontrol>New</uicontrol></cmd></step>
<step><cmd>Enter the appropriate values to create a new custom variable</cmd>
<info><lines>Name: prec_d_mapper
Value: <varname>{Your Name}</varname>
Description: Writer name</lines></info></step>
<step><cmd>Click <uicontrol>OK</uicontrol></cmd></step></steps></taskbody></task>
52. Semantic markup
• Using semantic markup, we can
• disambiguate content
• search based on meaning
• connect to other content, and
• reuse or substitute new text.
54. Intelligent Content
• Content that is
• not limited to one
• purpose
• technology, or
• output
• structurally rich and semantically aware, making it
• discoverable
• reusable
• reconfigurable, and
• adaptable.
56. What is DITA? (n. dit-uh)
• (Darwin Information Typing Architecture)
is an XML standard
• developed in late 90’s at IBM, and
• given to the open source community in 2004
• used for topic-based, structured
authoring
• designed for scalability using mechanisms
for specialization and inheritance
• defining an extendable set of information
types
59. DITA maps
• Standard DITA information model
• identifies and presents user tasks
• maps topics to task flow
• supplements with
• conceptual and
• reference material.
• Maps organize topics into
context for publication
• They manage relationships
between all topics
Alarm Clock User Guide
About Alarm Clocks
Setting Clock
Setting Wake Up Alarm
Setting Radio Alarm
Installing Batteries
Radio Settings
Battery Specifications
66. Who Uses DITA?
• Hundreds of companies worldwide,
including:
• Adobe, Apple, Caterpillar, Dell, Elekta,
IBM, Juniper Networks, McAfee,
Nokia, PayPal, Philips, RIM, SAP, SDL,
Xerox and many more
• IBM publishes 60M pages of
content in 40 languages using DITA