SlideShare una empresa de Scribd logo
1 de 19
Descargar para leer sin conexión
CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 1
Cross-format content with Lightweight DITA
Michael Priestley, Enterprise Content Technology Strategist, IBM CIO
Jenifer Schlotfeldt, Senior Content Strategist and Designer, IBM Bluemix
Carlos Evia, Director of Technical and Professional Writing, Virginia Tech
CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 2
Important Disclaimer
THE INFORMATION CONTAINED IN THIS PRESENTATION IS PROVIDED FOR INFORMATIONAL PURPOSES ONLY.
WHILE EFFORTS WERE MADE TO VERIFY THE COMPLETENESS AND ACCURACY OF THE INFORMATION
CONTAINED IN THIS PRESENTATION, IT IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED.
IN ADDITION, THIS INFORMATION IS BASED ON IBM’S CURRENT PRODUCT PLANS AND STRATEGY, WHICH ARE
SUBJECT TO CHANGE BY IBM WITHOUT NOTICE.
IBM SHALL NOT BE RESPONSIBLE FOR ANY DAMAGES ARISING OUT OF THE USE OF, OR OTHERWISE RELATED
TO, THIS PRESENTATION OR ANY OTHER DOCUMENTATION.
NOTHING CONTAINED IN THIS PRESENTATION IS INTENDED TO, OR SHALL HAVE THE EFFECT OF:
• CREATING ANY WARRANTY OR REPRESENTATION FROM IBM (OR ITS AFFILIATES
OR ITS OR THEIR SUPPLIERS AND/OR LICENSORS); OR
• ALTERING THE TERMS AND CONDITIONS OF THE APPLICABLE LICENSE
AGREEMENT GOVERNING THE USE OF IBM SOFTWARE.
CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 3
What have we covered so far?
CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 4
• Why Lightweight DITA?
o Lower complexity for easier adoption
o Also allows mapping across formats
o Which allows easier adoption
• Minimal topic
o Fewer elements
o Simpler content models
o Functional attribute groupings
• Minimal map
o For managing topic collections, variable
text, variable links, metadata/taxonomies
• Minimal specialization
o Start with an instance – for example, a
topic or a task
o Annotate to define content model
o Annotate to provide docs and more
o Conref to reuse definitions across
specializations
Lightweight DITA
<!DOCTYPE topic>
CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 5
oWhy Markdown?
 Enable easier collaboration on
documentation in a format familiar to
developers
 Minimal tagging learning curve
oYou can do minimal extensions to keep
it simple, but enable key advanced
features of DITA
 Standards for accessibility and HTML 5
 Headers, Footers
 TOC
 Content references
 Attributes
Working in Markdown
CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 6
• HDITA is HTML5-based
• Can be used for source
format or presentation
• Does not need a DITA Open
Toolkit transformation to
produce user deliverables
• Is compatible with DITA XML
• Presents a simpler way to
author technical content.
Working in HTML (HDITA)
CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 7
What if your team is using multiple formats?
CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 8
your project
your company
your content
ecosystem
Discussion
Define “team”
CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 9
Developers Writing specs In Markdown
Published to
website,
product spec
sheet
Marketers Writing
overviews
In a web
CMS/HTML5
Published to
website,
product
brochure
Technical
writers
Writing
procedures
In an XML
editor
Published to
website,
product docs
Let’s say this is your team
Remote Lighting Network
CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 10
Do your own
thing
Each group has its own
authoring tools and
website
Share content by copy
and paste
Let google pick the
winner!
Do somebody
else’s thing
Pick a winner yourself –
one authoring tool, one
website
Drink the salty tears of
the authors in the other
two groups
Or we could
work together
Authors have their
choice of tool and format
Delivery channels are
coordinated and
differentiated
Everyone’s a winner!
What are our options?
CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 11
Can they work together?
CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 12
Multi-format, Reuse flow
HTML
Remote Network
Lighting
XML
<ph
keyref="product-
name"/>
Markdown
[product-name]
Output to HTML5, PDF,
EPub, and more
DITA Map
<topicref
format=“html”/>
<topicref
format=“markdown”/>
<topicref
format=“dita”/>
CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 13
Demo
CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 14
Flexibility
• What if developer
takes over some
tasks?
• What if technical writer
takes over some
marketing pages?
• What if task pages
move into the web
CMS?
Coordination
• Share content across
collections with
topicref
• Coordinate variables
with keyref
• (To be built) common
metadata, filtering,
conref
Scope
• What if tasks need to
be published into
support knowledge
base?
• What if overviews and
product details need to
be pulled into RFPs?
• What if tasks and
overviews need to
become embedded
instructions?
What does a standard buy?
CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 15
What’s next?
CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 16
• Check out Lightweight DITA support in the DITA Open Toolkit
oMarkdown support: https://github.com/jelovirt/dita-ot-markdown
oHTML support: https://github.com/jelovirt/com.elovirta.dita.html
oIf you like what you see there or use the DITA-OT, support the
developer, Jarno Elovirta
oDonation links on the plugin pages
• Play with the sample files we used here:
o https://github.com/VT-CHCI/mixedlightweightdita
Play with what you saw today
CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 17
• Check out the vendor demos
o SimplyXML, FontoXML, and Oxygen all have lightweight DITA support
• Discuss what you learn in our LinkedIn group
o https://www.linkedin.com/groups/4943862
• Join the OASIS Lightweight DITA subcommittee
ohttps://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita-
lightweight-dita
• Contribute to the new Lightweight DITA Open Repository
o https://github.com/oasis-open/dita-lightweight
See more, do more
CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 18
• Joe Storbeck, Jana
• Keith Schengili-Roberts, Ixiasoft
• Kris Eberlein, Eberlein Consulting
• Mark Giffin
• Mark Poston, Mekon
• Michael Priestley, IBM
• Noz Urbina
• Rahel Bailie
• Rob Hanna, Precision Content
• Scott Hudson, Boeing
• Sissi Closs
• Tim Grantham
• Tom Comerford
• Tom Magliery, JustSystems
Thanks to the members of the Lightweight DITA SC
• Aaron Rothschild
• Amber Swope
• Birgit Strackenbrock
• Bryan Schnabel
• Carlos Evia, Virginia Tech
• Don Day
• Edwina Lui, Kaplan Publishing
• Fredrik Geers, SDL
• Ian Balanza-Davis
• Jan Benedictus, Fonto Group BV
• Jang Graat
• Jim Tivy, Bluestream
• Joe Pairman, Mekon
• John Hunt, IBM
CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 19
Legal
IBM and the IBM logo are trademarks of International Business
Machines Corp., registered in many jurisdictions worldwide.
Other product and service names might be trademarks of IBM or
other companies. A current list of IBM trademarks is available on
the Web at “Copyright and trademark information” at
www.ibm.com/legal/copytrade.shtml

Más contenido relacionado

La actualidad más candente

Enterprise information architecture: a case study in progress
Enterprise information architecture: a case study in progressEnterprise information architecture: a case study in progress
Enterprise information architecture: a case study in progressMichael Priestley
 
Updating content types for marketing and omnichannel
Updating content types for marketing and omnichannelUpdating content types for marketing and omnichannel
Updating content types for marketing and omnichannelMichael Priestley
 
Don’t Hide Your Content in a Traditional Help System: A Case Study from TechP...
Don’t Hide Your Content in a Traditional Help System: A Case Study from TechP...Don’t Hide Your Content in a Traditional Help System: A Case Study from TechP...
Don’t Hide Your Content in a Traditional Help System: A Case Study from TechP...Sarah Silveri, RSI Content Solutions
 
How DocZone is helping Unica Corporation to achieve new production milestones...
How DocZone is helping Unica Corporation to achieve new production milestones...How DocZone is helping Unica Corporation to achieve new production milestones...
How DocZone is helping Unica Corporation to achieve new production milestones...Sarah Silveri, RSI Content Solutions
 
Content Goes In, Products Come Out: End-to-End Publishing with RSuite, eXtyle...
Content Goes In, Products Come Out: End-to-End Publishing with RSuite, eXtyle...Content Goes In, Products Come Out: End-to-End Publishing with RSuite, eXtyle...
Content Goes In, Products Come Out: End-to-End Publishing with RSuite, eXtyle...Sarah Silveri, RSI Content Solutions
 
“It’s not rocket science!” Applying CMS and semantic enrichment to transform...
“It’s not rocket science!”  Applying CMS and semantic enrichment to transform...“It’s not rocket science!”  Applying CMS and semantic enrichment to transform...
“It’s not rocket science!” Applying CMS and semantic enrichment to transform...Sarah Silveri, RSI Content Solutions
 
How to manage projects with Microsoft teams
How to manage projects with Microsoft teams How to manage projects with Microsoft teams
How to manage projects with Microsoft teams Tuan Yang
 
Using Markdown and Lightweight DITA in a Collaborative Environment
Using Markdown and Lightweight DITA in a Collaborative EnvironmentUsing Markdown and Lightweight DITA in a Collaborative Environment
Using Markdown and Lightweight DITA in a Collaborative EnvironmentIXIASOFT
 
Single-Sourcing with RoboHelp 9: Presentation by WritePoint
Single-Sourcing with RoboHelp 9: Presentation by WritePointSingle-Sourcing with RoboHelp 9: Presentation by WritePoint
Single-Sourcing with RoboHelp 9: Presentation by WritePointPaula Stern
 
JTC Event 2012 - Provincial Microsoft License Renewal - Edna Dach, Dave Hausc...
JTC Event 2012 - Provincial Microsoft License Renewal - Edna Dach, Dave Hausc...JTC Event 2012 - Provincial Microsoft License Renewal - Edna Dach, Dave Hausc...
JTC Event 2012 - Provincial Microsoft License Renewal - Edna Dach, Dave Hausc...Alberta Education
 
IBM's Client Technical Content Experience Strategy Overview
IBM's Client Technical Content Experience Strategy OverviewIBM's Client Technical Content Experience Strategy Overview
IBM's Client Technical Content Experience Strategy OverviewMichael Priestley
 
Is DITA Right for You? - STC Summit 2017
Is DITA Right for You? - STC Summit 2017Is DITA Right for You? - STC Summit 2017
Is DITA Right for You? - STC Summit 2017IXIASOFT
 
Office 365 met student advantage
Office 365 met student advantageOffice 365 met student advantage
Office 365 met student advantageRemco Ploeg
 
Share Australia - Looking to the future - SharePoint in the Cloud
Share Australia - Looking to the future - SharePoint in the CloudShare Australia - Looking to the future - SharePoint in the Cloud
Share Australia - Looking to the future - SharePoint in the CloudRichard Harbridge
 

La actualidad más candente (20)

Lightweight DITA
Lightweight DITALightweight DITA
Lightweight DITA
 
Enterprise information architecture: a case study in progress
Enterprise information architecture: a case study in progressEnterprise information architecture: a case study in progress
Enterprise information architecture: a case study in progress
 
Updating content types for marketing and omnichannel
Updating content types for marketing and omnichannelUpdating content types for marketing and omnichannel
Updating content types for marketing and omnichannel
 
Don’t Hide Your Content in a Traditional Help System: A Case Study from TechP...
Don’t Hide Your Content in a Traditional Help System: A Case Study from TechP...Don’t Hide Your Content in a Traditional Help System: A Case Study from TechP...
Don’t Hide Your Content in a Traditional Help System: A Case Study from TechP...
 
DITA For Publishers: How Publishers Can Really Do XML
DITA For Publishers: How Publishers Can Really Do XMLDITA For Publishers: How Publishers Can Really Do XML
DITA For Publishers: How Publishers Can Really Do XML
 
Start > Automate > Create | Book Publishing in the Cloud
Start > Automate > Create | Book Publishing in the CloudStart > Automate > Create | Book Publishing in the Cloud
Start > Automate > Create | Book Publishing in the Cloud
 
How DocZone is helping Unica Corporation to achieve new production milestones...
How DocZone is helping Unica Corporation to achieve new production milestones...How DocZone is helping Unica Corporation to achieve new production milestones...
How DocZone is helping Unica Corporation to achieve new production milestones...
 
Content Goes In, Products Come Out: End-to-End Publishing with RSuite, eXtyle...
Content Goes In, Products Come Out: End-to-End Publishing with RSuite, eXtyle...Content Goes In, Products Come Out: End-to-End Publishing with RSuite, eXtyle...
Content Goes In, Products Come Out: End-to-End Publishing with RSuite, eXtyle...
 
“It’s not rocket science!” Applying CMS and semantic enrichment to transform...
“It’s not rocket science!”  Applying CMS and semantic enrichment to transform...“It’s not rocket science!”  Applying CMS and semantic enrichment to transform...
“It’s not rocket science!” Applying CMS and semantic enrichment to transform...
 
How to manage projects with Microsoft teams
How to manage projects with Microsoft teams How to manage projects with Microsoft teams
How to manage projects with Microsoft teams
 
Using Markdown and Lightweight DITA in a Collaborative Environment
Using Markdown and Lightweight DITA in a Collaborative EnvironmentUsing Markdown and Lightweight DITA in a Collaborative Environment
Using Markdown and Lightweight DITA in a Collaborative Environment
 
Single-Sourcing with RoboHelp 9: Presentation by WritePoint
Single-Sourcing with RoboHelp 9: Presentation by WritePointSingle-Sourcing with RoboHelp 9: Presentation by WritePoint
Single-Sourcing with RoboHelp 9: Presentation by WritePoint
 
JTC Event 2012 - Provincial Microsoft License Renewal - Edna Dach, Dave Hausc...
JTC Event 2012 - Provincial Microsoft License Renewal - Edna Dach, Dave Hausc...JTC Event 2012 - Provincial Microsoft License Renewal - Edna Dach, Dave Hausc...
JTC Event 2012 - Provincial Microsoft License Renewal - Edna Dach, Dave Hausc...
 
IBM's Client Technical Content Experience Strategy Overview
IBM's Client Technical Content Experience Strategy OverviewIBM's Client Technical Content Experience Strategy Overview
IBM's Client Technical Content Experience Strategy Overview
 
A lightweight DITA update
A lightweight DITA updateA lightweight DITA update
A lightweight DITA update
 
Office 365, is cloud right for your company?
Office 365, is cloud right for your company?Office 365, is cloud right for your company?
Office 365, is cloud right for your company?
 
Is DITA Right for You? - STC Summit 2017
Is DITA Right for You? - STC Summit 2017Is DITA Right for You? - STC Summit 2017
Is DITA Right for You? - STC Summit 2017
 
A Publisher’s Guide to Choosing the Right XML Editor
A Publisher’s Guide to Choosing the Right XML EditorA Publisher’s Guide to Choosing the Right XML Editor
A Publisher’s Guide to Choosing the Right XML Editor
 
Office 365 met student advantage
Office 365 met student advantageOffice 365 met student advantage
Office 365 met student advantage
 
Share Australia - Looking to the future - SharePoint in the Cloud
Share Australia - Looking to the future - SharePoint in the CloudShare Australia - Looking to the future - SharePoint in the Cloud
Share Australia - Looking to the future - SharePoint in the Cloud
 

Similar a Cross-format content with Lightweight DITA

Building a Documentation Portal
Building a Documentation PortalBuilding a Documentation Portal
Building a Documentation Portalstc-siliconvalley
 
Findable, Usable, Reusable: IBM's Enterprise Content Technology Strategy for ...
Findable, Usable, Reusable: IBM's Enterprise Content Technology Strategy for ...Findable, Usable, Reusable: IBM's Enterprise Content Technology Strategy for ...
Findable, Usable, Reusable: IBM's Enterprise Content Technology Strategy for ...Michael Priestley
 
Finally! A Way to Make SharePoint Useful
Finally! A Way to Make SharePoint UsefulFinally! A Way to Make SharePoint Useful
Finally! A Way to Make SharePoint UsefulAIIM International
 
LavaCon 2017 - Implementing a Customer-driven Transition to DITA Content: A S...
LavaCon 2017 - Implementing a Customer-driven Transition to DITA Content: A S...LavaCon 2017 - Implementing a Customer-driven Transition to DITA Content: A S...
LavaCon 2017 - Implementing a Customer-driven Transition to DITA Content: A S...Jack Molisani
 
Changing how we think about content
Changing how we think about contentChanging how we think about content
Changing how we think about contentRob Hanna, ECMs
 
Evaluating Collaboration Tools for Your Small Business
Evaluating Collaboration Tools for Your Small BusinessEvaluating Collaboration Tools for Your Small Business
Evaluating Collaboration Tools for Your Small BusinessSamepage
 
Need to reboot your content creation strategy? Start with "No"
Need to reboot your content creation strategy? Start with "No"Need to reboot your content creation strategy? Start with "No"
Need to reboot your content creation strategy? Start with "No"Keith Boyd
 
Oracle Multichannel Content Management
Oracle Multichannel Content ManagementOracle Multichannel Content Management
Oracle Multichannel Content ManagementOracle
 
Leading Your Business To Success & The Cloud
Leading Your Business To Success & The CloudLeading Your Business To Success & The Cloud
Leading Your Business To Success & The CloudRichard Harbridge
 
Bar Napkins and XML: Eliminating the Hidden Cost of Content Conversion
Bar Napkins and XML: Eliminating the Hidden Cost of Content ConversionBar Napkins and XML: Eliminating the Hidden Cost of Content Conversion
Bar Napkins and XML: Eliminating the Hidden Cost of Content ConversionDustin Vaughn
 
2008-2014 Integration Design - Course Summary for slideshare.pdf
2008-2014 Integration Design - Course Summary for slideshare.pdf2008-2014 Integration Design - Course Summary for slideshare.pdf
2008-2014 Integration Design - Course Summary for slideshare.pdfKim Clark
 
Spark working with a Cloud IDE: Notebook/Shiny Apps
Spark working with a Cloud IDE: Notebook/Shiny AppsSpark working with a Cloud IDE: Notebook/Shiny Apps
Spark working with a Cloud IDE: Notebook/Shiny AppsData Con LA
 
Exploiting SharePoint 2013 for improved “Findability” of People and Content
Exploiting SharePoint 2013 for improved “Findability” of People and ContentExploiting SharePoint 2013 for improved “Findability” of People and Content
Exploiting SharePoint 2013 for improved “Findability” of People and ContentAIIM International
 
App.Next - The Future of Domino Application Development
App.Next - The Future of Domino Application DevelopmentApp.Next - The Future of Domino Application Development
App.Next - The Future of Domino Application DevelopmentTeamstudio
 
Data-Driven to Know We Have Effective Content with Jenifer Schlotfeldt and Co...
Data-Driven to Know We Have Effective Content with Jenifer Schlotfeldt and Co...Data-Driven to Know We Have Effective Content with Jenifer Schlotfeldt and Co...
Data-Driven to Know We Have Effective Content with Jenifer Schlotfeldt and Co...Information Development World
 
IBM Mail Next and Notes/Domino Roadmap
IBM Mail Next and Notes/Domino RoadmapIBM Mail Next and Notes/Domino Roadmap
IBM Mail Next and Notes/Domino RoadmapTeamstudio
 

Similar a Cross-format content with Lightweight DITA (20)

Surviving the Hadoop Revolution
Surviving the Hadoop RevolutionSurviving the Hadoop Revolution
Surviving the Hadoop Revolution
 
Building a Documentation Portal
Building a Documentation PortalBuilding a Documentation Portal
Building a Documentation Portal
 
Findable, Usable, Reusable: IBM's Enterprise Content Technology Strategy for ...
Findable, Usable, Reusable: IBM's Enterprise Content Technology Strategy for ...Findable, Usable, Reusable: IBM's Enterprise Content Technology Strategy for ...
Findable, Usable, Reusable: IBM's Enterprise Content Technology Strategy for ...
 
Finally! A Way to Make SharePoint Useful
Finally! A Way to Make SharePoint UsefulFinally! A Way to Make SharePoint Useful
Finally! A Way to Make SharePoint Useful
 
LavaCon 2017 - Implementing a Customer-driven Transition to DITA Content: A S...
LavaCon 2017 - Implementing a Customer-driven Transition to DITA Content: A S...LavaCon 2017 - Implementing a Customer-driven Transition to DITA Content: A S...
LavaCon 2017 - Implementing a Customer-driven Transition to DITA Content: A S...
 
Changing how we think about content
Changing how we think about contentChanging how we think about content
Changing how we think about content
 
Evaluating Collaboration Tools for Your Small Business
Evaluating Collaboration Tools for Your Small BusinessEvaluating Collaboration Tools for Your Small Business
Evaluating Collaboration Tools for Your Small Business
 
OS Accelerate London - 09/16/15
OS Accelerate London - 09/16/15OS Accelerate London - 09/16/15
OS Accelerate London - 09/16/15
 
Need to reboot your content creation strategy? Start with "No"
Need to reboot your content creation strategy? Start with "No"Need to reboot your content creation strategy? Start with "No"
Need to reboot your content creation strategy? Start with "No"
 
Internationalizing Your Content
Internationalizing Your ContentInternationalizing Your Content
Internationalizing Your Content
 
Internationalizing Your Content
Internationalizing Your ContentInternationalizing Your Content
Internationalizing Your Content
 
Oracle Multichannel Content Management
Oracle Multichannel Content ManagementOracle Multichannel Content Management
Oracle Multichannel Content Management
 
Leading Your Business To Success & The Cloud
Leading Your Business To Success & The CloudLeading Your Business To Success & The Cloud
Leading Your Business To Success & The Cloud
 
Bar Napkins and XML: Eliminating the Hidden Cost of Content Conversion
Bar Napkins and XML: Eliminating the Hidden Cost of Content ConversionBar Napkins and XML: Eliminating the Hidden Cost of Content Conversion
Bar Napkins and XML: Eliminating the Hidden Cost of Content Conversion
 
2008-2014 Integration Design - Course Summary for slideshare.pdf
2008-2014 Integration Design - Course Summary for slideshare.pdf2008-2014 Integration Design - Course Summary for slideshare.pdf
2008-2014 Integration Design - Course Summary for slideshare.pdf
 
Spark working with a Cloud IDE: Notebook/Shiny Apps
Spark working with a Cloud IDE: Notebook/Shiny AppsSpark working with a Cloud IDE: Notebook/Shiny Apps
Spark working with a Cloud IDE: Notebook/Shiny Apps
 
Exploiting SharePoint 2013 for improved “Findability” of People and Content
Exploiting SharePoint 2013 for improved “Findability” of People and ContentExploiting SharePoint 2013 for improved “Findability” of People and Content
Exploiting SharePoint 2013 for improved “Findability” of People and Content
 
App.Next - The Future of Domino Application Development
App.Next - The Future of Domino Application DevelopmentApp.Next - The Future of Domino Application Development
App.Next - The Future of Domino Application Development
 
Data-Driven to Know We Have Effective Content with Jenifer Schlotfeldt and Co...
Data-Driven to Know We Have Effective Content with Jenifer Schlotfeldt and Co...Data-Driven to Know We Have Effective Content with Jenifer Schlotfeldt and Co...
Data-Driven to Know We Have Effective Content with Jenifer Schlotfeldt and Co...
 
IBM Mail Next and Notes/Domino Roadmap
IBM Mail Next and Notes/Domino RoadmapIBM Mail Next and Notes/Domino Roadmap
IBM Mail Next and Notes/Domino Roadmap
 

Último

COMPUTER 10: Lesson 7 - File Storage and Online Collaboration
COMPUTER 10: Lesson 7 - File Storage and Online CollaborationCOMPUTER 10: Lesson 7 - File Storage and Online Collaboration
COMPUTER 10: Lesson 7 - File Storage and Online Collaborationbruanjhuli
 
UiPath Studio Web workshop series - Day 6
UiPath Studio Web workshop series - Day 6UiPath Studio Web workshop series - Day 6
UiPath Studio Web workshop series - Day 6DianaGray10
 
Machine Learning Model Validation (Aijun Zhang 2024).pdf
Machine Learning Model Validation (Aijun Zhang 2024).pdfMachine Learning Model Validation (Aijun Zhang 2024).pdf
Machine Learning Model Validation (Aijun Zhang 2024).pdfAijun Zhang
 
COMPUTER 10 Lesson 8 - Building a Website
COMPUTER 10 Lesson 8 - Building a WebsiteCOMPUTER 10 Lesson 8 - Building a Website
COMPUTER 10 Lesson 8 - Building a Websitedgelyza
 
Meet the new FSP 3000 M-Flex800™
Meet the new FSP 3000 M-Flex800™Meet the new FSP 3000 M-Flex800™
Meet the new FSP 3000 M-Flex800™Adtran
 
Artificial Intelligence & SEO Trends for 2024
Artificial Intelligence & SEO Trends for 2024Artificial Intelligence & SEO Trends for 2024
Artificial Intelligence & SEO Trends for 2024D Cloud Solutions
 
Secure your environment with UiPath and CyberArk technologies - Session 1
Secure your environment with UiPath and CyberArk technologies - Session 1Secure your environment with UiPath and CyberArk technologies - Session 1
Secure your environment with UiPath and CyberArk technologies - Session 1DianaGray10
 
UiPath Studio Web workshop series - Day 7
UiPath Studio Web workshop series - Day 7UiPath Studio Web workshop series - Day 7
UiPath Studio Web workshop series - Day 7DianaGray10
 
Apres-Cyber - The Data Dilemma: Bridging Offensive Operations and Machine Lea...
Apres-Cyber - The Data Dilemma: Bridging Offensive Operations and Machine Lea...Apres-Cyber - The Data Dilemma: Bridging Offensive Operations and Machine Lea...
Apres-Cyber - The Data Dilemma: Bridging Offensive Operations and Machine Lea...Will Schroeder
 
KubeConEU24-Monitoring Kubernetes and Cloud Spend with OpenCost
KubeConEU24-Monitoring Kubernetes and Cloud Spend with OpenCostKubeConEU24-Monitoring Kubernetes and Cloud Spend with OpenCost
KubeConEU24-Monitoring Kubernetes and Cloud Spend with OpenCostMatt Ray
 
Igniting Next Level Productivity with AI-Infused Data Integration Workflows
Igniting Next Level Productivity with AI-Infused Data Integration WorkflowsIgniting Next Level Productivity with AI-Infused Data Integration Workflows
Igniting Next Level Productivity with AI-Infused Data Integration WorkflowsSafe Software
 
OpenShift Commons Paris - Choose Your Own Observability Adventure
OpenShift Commons Paris - Choose Your Own Observability AdventureOpenShift Commons Paris - Choose Your Own Observability Adventure
OpenShift Commons Paris - Choose Your Own Observability AdventureEric D. Schabell
 
VoIP Service and Marketing using Odoo and Asterisk PBX
VoIP Service and Marketing using Odoo and Asterisk PBXVoIP Service and Marketing using Odoo and Asterisk PBX
VoIP Service and Marketing using Odoo and Asterisk PBXTarek Kalaji
 
activity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdf
activity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdf
activity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdfJamie (Taka) Wang
 
Basic Building Blocks of Internet of Things.
Basic Building Blocks of Internet of Things.Basic Building Blocks of Internet of Things.
Basic Building Blocks of Internet of Things.YounusS2
 
UiPath Solutions Management Preview - Northern CA Chapter - March 22.pdf
UiPath Solutions Management Preview - Northern CA Chapter - March 22.pdfUiPath Solutions Management Preview - Northern CA Chapter - March 22.pdf
UiPath Solutions Management Preview - Northern CA Chapter - March 22.pdfDianaGray10
 
Building Your Own AI Instance (TBLC AI )
Building Your Own AI Instance (TBLC AI )Building Your Own AI Instance (TBLC AI )
Building Your Own AI Instance (TBLC AI )Brian Pichman
 
IaC & GitOps in a Nutshell - a FridayInANuthshell Episode.pdf
IaC & GitOps in a Nutshell - a FridayInANuthshell Episode.pdfIaC & GitOps in a Nutshell - a FridayInANuthshell Episode.pdf
IaC & GitOps in a Nutshell - a FridayInANuthshell Episode.pdfDaniel Santiago Silva Capera
 
AI You Can Trust - Ensuring Success with Data Integrity Webinar
AI You Can Trust - Ensuring Success with Data Integrity WebinarAI You Can Trust - Ensuring Success with Data Integrity Webinar
AI You Can Trust - Ensuring Success with Data Integrity WebinarPrecisely
 

Último (20)

COMPUTER 10: Lesson 7 - File Storage and Online Collaboration
COMPUTER 10: Lesson 7 - File Storage and Online CollaborationCOMPUTER 10: Lesson 7 - File Storage and Online Collaboration
COMPUTER 10: Lesson 7 - File Storage and Online Collaboration
 
UiPath Studio Web workshop series - Day 6
UiPath Studio Web workshop series - Day 6UiPath Studio Web workshop series - Day 6
UiPath Studio Web workshop series - Day 6
 
Machine Learning Model Validation (Aijun Zhang 2024).pdf
Machine Learning Model Validation (Aijun Zhang 2024).pdfMachine Learning Model Validation (Aijun Zhang 2024).pdf
Machine Learning Model Validation (Aijun Zhang 2024).pdf
 
COMPUTER 10 Lesson 8 - Building a Website
COMPUTER 10 Lesson 8 - Building a WebsiteCOMPUTER 10 Lesson 8 - Building a Website
COMPUTER 10 Lesson 8 - Building a Website
 
Meet the new FSP 3000 M-Flex800™
Meet the new FSP 3000 M-Flex800™Meet the new FSP 3000 M-Flex800™
Meet the new FSP 3000 M-Flex800™
 
Artificial Intelligence & SEO Trends for 2024
Artificial Intelligence & SEO Trends for 2024Artificial Intelligence & SEO Trends for 2024
Artificial Intelligence & SEO Trends for 2024
 
Secure your environment with UiPath and CyberArk technologies - Session 1
Secure your environment with UiPath and CyberArk technologies - Session 1Secure your environment with UiPath and CyberArk technologies - Session 1
Secure your environment with UiPath and CyberArk technologies - Session 1
 
UiPath Studio Web workshop series - Day 7
UiPath Studio Web workshop series - Day 7UiPath Studio Web workshop series - Day 7
UiPath Studio Web workshop series - Day 7
 
Apres-Cyber - The Data Dilemma: Bridging Offensive Operations and Machine Lea...
Apres-Cyber - The Data Dilemma: Bridging Offensive Operations and Machine Lea...Apres-Cyber - The Data Dilemma: Bridging Offensive Operations and Machine Lea...
Apres-Cyber - The Data Dilemma: Bridging Offensive Operations and Machine Lea...
 
KubeConEU24-Monitoring Kubernetes and Cloud Spend with OpenCost
KubeConEU24-Monitoring Kubernetes and Cloud Spend with OpenCostKubeConEU24-Monitoring Kubernetes and Cloud Spend with OpenCost
KubeConEU24-Monitoring Kubernetes and Cloud Spend with OpenCost
 
Igniting Next Level Productivity with AI-Infused Data Integration Workflows
Igniting Next Level Productivity with AI-Infused Data Integration WorkflowsIgniting Next Level Productivity with AI-Infused Data Integration Workflows
Igniting Next Level Productivity with AI-Infused Data Integration Workflows
 
OpenShift Commons Paris - Choose Your Own Observability Adventure
OpenShift Commons Paris - Choose Your Own Observability AdventureOpenShift Commons Paris - Choose Your Own Observability Adventure
OpenShift Commons Paris - Choose Your Own Observability Adventure
 
VoIP Service and Marketing using Odoo and Asterisk PBX
VoIP Service and Marketing using Odoo and Asterisk PBXVoIP Service and Marketing using Odoo and Asterisk PBX
VoIP Service and Marketing using Odoo and Asterisk PBX
 
activity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdf
activity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdf
activity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdf
 
Basic Building Blocks of Internet of Things.
Basic Building Blocks of Internet of Things.Basic Building Blocks of Internet of Things.
Basic Building Blocks of Internet of Things.
 
20150722 - AGV
20150722 - AGV20150722 - AGV
20150722 - AGV
 
UiPath Solutions Management Preview - Northern CA Chapter - March 22.pdf
UiPath Solutions Management Preview - Northern CA Chapter - March 22.pdfUiPath Solutions Management Preview - Northern CA Chapter - March 22.pdf
UiPath Solutions Management Preview - Northern CA Chapter - March 22.pdf
 
Building Your Own AI Instance (TBLC AI )
Building Your Own AI Instance (TBLC AI )Building Your Own AI Instance (TBLC AI )
Building Your Own AI Instance (TBLC AI )
 
IaC & GitOps in a Nutshell - a FridayInANuthshell Episode.pdf
IaC & GitOps in a Nutshell - a FridayInANuthshell Episode.pdfIaC & GitOps in a Nutshell - a FridayInANuthshell Episode.pdf
IaC & GitOps in a Nutshell - a FridayInANuthshell Episode.pdf
 
AI You Can Trust - Ensuring Success with Data Integrity Webinar
AI You Can Trust - Ensuring Success with Data Integrity WebinarAI You Can Trust - Ensuring Success with Data Integrity Webinar
AI You Can Trust - Ensuring Success with Data Integrity Webinar
 

Cross-format content with Lightweight DITA

  • 1. CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 1 Cross-format content with Lightweight DITA Michael Priestley, Enterprise Content Technology Strategist, IBM CIO Jenifer Schlotfeldt, Senior Content Strategist and Designer, IBM Bluemix Carlos Evia, Director of Technical and Professional Writing, Virginia Tech
  • 2. CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 2 Important Disclaimer THE INFORMATION CONTAINED IN THIS PRESENTATION IS PROVIDED FOR INFORMATIONAL PURPOSES ONLY. WHILE EFFORTS WERE MADE TO VERIFY THE COMPLETENESS AND ACCURACY OF THE INFORMATION CONTAINED IN THIS PRESENTATION, IT IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. IN ADDITION, THIS INFORMATION IS BASED ON IBM’S CURRENT PRODUCT PLANS AND STRATEGY, WHICH ARE SUBJECT TO CHANGE BY IBM WITHOUT NOTICE. IBM SHALL NOT BE RESPONSIBLE FOR ANY DAMAGES ARISING OUT OF THE USE OF, OR OTHERWISE RELATED TO, THIS PRESENTATION OR ANY OTHER DOCUMENTATION. NOTHING CONTAINED IN THIS PRESENTATION IS INTENDED TO, OR SHALL HAVE THE EFFECT OF: • CREATING ANY WARRANTY OR REPRESENTATION FROM IBM (OR ITS AFFILIATES OR ITS OR THEIR SUPPLIERS AND/OR LICENSORS); OR • ALTERING THE TERMS AND CONDITIONS OF THE APPLICABLE LICENSE AGREEMENT GOVERNING THE USE OF IBM SOFTWARE.
  • 3. CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 3 What have we covered so far?
  • 4. CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 4 • Why Lightweight DITA? o Lower complexity for easier adoption o Also allows mapping across formats o Which allows easier adoption • Minimal topic o Fewer elements o Simpler content models o Functional attribute groupings • Minimal map o For managing topic collections, variable text, variable links, metadata/taxonomies • Minimal specialization o Start with an instance – for example, a topic or a task o Annotate to define content model o Annotate to provide docs and more o Conref to reuse definitions across specializations Lightweight DITA <!DOCTYPE topic>
  • 5. CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 5 oWhy Markdown?  Enable easier collaboration on documentation in a format familiar to developers  Minimal tagging learning curve oYou can do minimal extensions to keep it simple, but enable key advanced features of DITA  Standards for accessibility and HTML 5  Headers, Footers  TOC  Content references  Attributes Working in Markdown
  • 6. CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 6 • HDITA is HTML5-based • Can be used for source format or presentation • Does not need a DITA Open Toolkit transformation to produce user deliverables • Is compatible with DITA XML • Presents a simpler way to author technical content. Working in HTML (HDITA)
  • 7. CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 7 What if your team is using multiple formats?
  • 8. CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 8 your project your company your content ecosystem Discussion Define “team”
  • 9. CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 9 Developers Writing specs In Markdown Published to website, product spec sheet Marketers Writing overviews In a web CMS/HTML5 Published to website, product brochure Technical writers Writing procedures In an XML editor Published to website, product docs Let’s say this is your team Remote Lighting Network
  • 10. CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 10 Do your own thing Each group has its own authoring tools and website Share content by copy and paste Let google pick the winner! Do somebody else’s thing Pick a winner yourself – one authoring tool, one website Drink the salty tears of the authors in the other two groups Or we could work together Authors have their choice of tool and format Delivery channels are coordinated and differentiated Everyone’s a winner! What are our options?
  • 11. CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 11 Can they work together?
  • 12. CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 12 Multi-format, Reuse flow HTML Remote Network Lighting XML <ph keyref="product- name"/> Markdown [product-name] Output to HTML5, PDF, EPub, and more DITA Map <topicref format=“html”/> <topicref format=“markdown”/> <topicref format=“dita”/>
  • 13. CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 13 Demo
  • 14. CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 14 Flexibility • What if developer takes over some tasks? • What if technical writer takes over some marketing pages? • What if task pages move into the web CMS? Coordination • Share content across collections with topicref • Coordinate variables with keyref • (To be built) common metadata, filtering, conref Scope • What if tasks need to be published into support knowledge base? • What if overviews and product details need to be pulled into RFPs? • What if tasks and overviews need to become embedded instructions? What does a standard buy?
  • 15. CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 15 What’s next?
  • 16. CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 16 • Check out Lightweight DITA support in the DITA Open Toolkit oMarkdown support: https://github.com/jelovirt/dita-ot-markdown oHTML support: https://github.com/jelovirt/com.elovirta.dita.html oIf you like what you see there or use the DITA-OT, support the developer, Jarno Elovirta oDonation links on the plugin pages • Play with the sample files we used here: o https://github.com/VT-CHCI/mixedlightweightdita Play with what you saw today
  • 17. CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 17 • Check out the vendor demos o SimplyXML, FontoXML, and Oxygen all have lightweight DITA support • Discuss what you learn in our LinkedIn group o https://www.linkedin.com/groups/4943862 • Join the OASIS Lightweight DITA subcommittee ohttps://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita- lightweight-dita • Contribute to the new Lightweight DITA Open Repository o https://github.com/oasis-open/dita-lightweight See more, do more
  • 18. CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 18 • Joe Storbeck, Jana • Keith Schengili-Roberts, Ixiasoft • Kris Eberlein, Eberlein Consulting • Mark Giffin • Mark Poston, Mekon • Michael Priestley, IBM • Noz Urbina • Rahel Bailie • Rob Hanna, Precision Content • Scott Hudson, Boeing • Sissi Closs • Tim Grantham • Tom Comerford • Tom Magliery, JustSystems Thanks to the members of the Lightweight DITA SC • Aaron Rothschild • Amber Swope • Birgit Strackenbrock • Bryan Schnabel • Carlos Evia, Virginia Tech • Don Day • Edwina Lui, Kaplan Publishing • Fredrik Geers, SDL • Ian Balanza-Davis • Jan Benedictus, Fonto Group BV • Jang Graat • Jim Tivy, Bluestream • Joe Pairman, Mekon • John Hunt, IBM
  • 19. CIO Enterprise Content | ©Copyright IBM Corp. 2014, 2016 19 Legal IBM and the IBM logo are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at “Copyright and trademark information” at www.ibm.com/legal/copytrade.shtml