SlideShare ist ein Scribd-Unternehmen logo
1 von 14
Downloaden Sie, um offline zu lesen
Don’t be afraid of DITA
your people will love it 

Professor Sissi Closs
Hochschule Karlsruhe
Comet Computer GmbH, Comet Communication GmbH

© Comet Computer GmbH, Comet Communication GmbH
Your people will love it 

© Comet Computer GmbH, Comet Communication GmbH
Benefits of using DITA


Dita supports topic-oriented structuring including
typing and is a standard.



DITA expertise grows.



Knowledge of how to use DITA grows.



The tool landscape continues to grow.

© Comet Computer GmbH, Comet Communication GmbH
Challenges


How to start?



How to structure?



How to organize everything?

© Comet Computer GmbH, Comet Communication GmbH
How to start?
start?
Tech Doc Experts

Others

 Analyze Content
 Categorize
 Create topic type

 Use predefined



templates / forms

 Fill-in topics / templates

templates
Define information
architectures

© Comet Computer GmbH, Comet Communication GmbH
How to start: Tech Doc Experts
start:

© Comet Computer GmbH, Comet Communication GmbH
How to start: Others
start:

© Comet Computer GmbH, Comet Communication GmbH
How to structure?
structure?
Tech Doc Experts

Others











Explicitely tag content
Create separate topics
Use XML tools
Make us of complete
feature set

Use only preselected tag subset
Write content in context
Use Wysiwyg tool (no tags)
Use simple predefined
constructs

© Comet Computer GmbH, Comet Communication GmbH
How to structure: Tech Doc Experts
structure:

© Comet Computer GmbH, Comet Communication GmbH
How to structure: Others
structure:
Solution 1






Authors write in a well prepared Word template.
VBA macro generates more complex structures.
VBA macro generates XML (“simplified DITA”).
XSLT generates DITA topics.
FrameMaker plug-ins, e.g. for CMS connection,
metadata retrieval and update

© Comet Computer GmbH, Comet Communication GmbH
How to structure: Others
structure:
Solution 2
1.
2.
3.
4.

Authors write with basic “normal.dot” Word template
VBA macro generates formatted Word document.
Editors finalize this Word document.
Tool chain as in solution 1:





VBA macro generates more complex structures
VBA macro generates XML (“simplified DITA”)
XSLT generates DITA topics
FrameMaker plug-ins, e.g. for CMS connection,
metadata retrieval and update

© Comet Computer GmbH, Comet Communication GmbH
Complete Tool Solutions
Input

DITA environment

Publications

© Comet Computer GmbH, Comet Communication GmbH
Why people love it







Multiple output (epub format, word, pdf) in good output
quality
Easy content exchange, combination, and integration
Fast results
Documentation that looks more professional
Less maintainance
Not working isolated

© Comet Computer GmbH, Comet Communication GmbH
Questions?



Thank you for your attention
www.comet.de

© Comet Computer GmbH, Comet Communication GmbH

Weitere ähnliche Inhalte

Ähnlich wie Closs

Ähnlich wie Closs (20)

How to reduce DTP and translation costs with FrameMaker
How to reduce DTP and translation costs with FrameMakerHow to reduce DTP and translation costs with FrameMaker
How to reduce DTP and translation costs with FrameMaker
 
Jmp108
Jmp108Jmp108
Jmp108
 
[Case Study] - Nuclear Power, DITA and FrameMaker: The How's and Why's
[Case Study] - Nuclear Power, DITA and FrameMaker: The How's and Why's[Case Study] - Nuclear Power, DITA and FrameMaker: The How's and Why's
[Case Study] - Nuclear Power, DITA and FrameMaker: The How's and Why's
 
Markup For Dummies (Russ Ward)
Markup For Dummies (Russ Ward)Markup For Dummies (Russ Ward)
Markup For Dummies (Russ Ward)
 
Implementing Structured FrameMaker
Implementing Structured FrameMakerImplementing Structured FrameMaker
Implementing Structured FrameMaker
 
Bp309
Bp309Bp309
Bp309
 
One Dsl4negotiations Presented
One Dsl4negotiations PresentedOne Dsl4negotiations Presented
One Dsl4negotiations Presented
 
Composite C1 Presentaion
Composite C1  PresentaionComposite C1  Presentaion
Composite C1 Presentaion
 
Tasks Your Business Should Automate in 2022 That Just Make Sense
Tasks Your Business Should Automate in 2022 That Just Make SenseTasks Your Business Should Automate in 2022 That Just Make Sense
Tasks Your Business Should Automate in 2022 That Just Make Sense
 
Code generation
Code generationCode generation
Code generation
 
Save time and your sanity: Increase your efficiency with Microsoft Word (shor...
Save time and your sanity: Increase your efficiency with Microsoft Word (shor...Save time and your sanity: Increase your efficiency with Microsoft Word (shor...
Save time and your sanity: Increase your efficiency with Microsoft Word (shor...
 
Marcus Kesseler: Weaving XML Into Your Workflows: Use Cases, Tools, Pitfalls ...
Marcus Kesseler: Weaving XML Into Your Workflows: Use Cases, Tools, Pitfalls ...Marcus Kesseler: Weaving XML Into Your Workflows: Use Cases, Tools, Pitfalls ...
Marcus Kesseler: Weaving XML Into Your Workflows: Use Cases, Tools, Pitfalls ...
 
Building An XML Publishing System With DITA
Building An XML Publishing System With DITABuilding An XML Publishing System With DITA
Building An XML Publishing System With DITA
 
Hss Trends May2009c
Hss Trends May2009cHss Trends May2009c
Hss Trends May2009c
 
DITA support in FrameMaker and XMetaL
DITA support in FrameMaker and XMetaLDITA support in FrameMaker and XMetaL
DITA support in FrameMaker and XMetaL
 
ILUG 2007 - Notes and Office Integration
ILUG 2007 - Notes and Office IntegrationILUG 2007 - Notes and Office Integration
ILUG 2007 - Notes and Office Integration
 
5 Reasons not to use Dita from a CCMS Perspective
5 Reasons not to use Dita from a CCMS Perspective5 Reasons not to use Dita from a CCMS Perspective
5 Reasons not to use Dita from a CCMS Perspective
 
Putting DITA Localization into Practice
Putting DITA Localization into PracticePutting DITA Localization into Practice
Putting DITA Localization into Practice
 
Bp205
Bp205Bp205
Bp205
 
Part i
Part iPart i
Part i
 

Kürzlich hochgeladen

Hyatt driving innovation and exceptional customer experiences with FIDO passw...
Hyatt driving innovation and exceptional customer experiences with FIDO passw...Hyatt driving innovation and exceptional customer experiences with FIDO passw...
Hyatt driving innovation and exceptional customer experiences with FIDO passw...
FIDO Alliance
 
Harnessing Passkeys in the Battle Against AI-Powered Cyber Threats.pptx
Harnessing Passkeys in the Battle Against AI-Powered Cyber Threats.pptxHarnessing Passkeys in the Battle Against AI-Powered Cyber Threats.pptx
Harnessing Passkeys in the Battle Against AI-Powered Cyber Threats.pptx
FIDO Alliance
 
Tales from a Passkey Provider Progress from Awareness to Implementation.pptx
Tales from a Passkey Provider  Progress from Awareness to Implementation.pptxTales from a Passkey Provider  Progress from Awareness to Implementation.pptx
Tales from a Passkey Provider Progress from Awareness to Implementation.pptx
FIDO Alliance
 

Kürzlich hochgeladen (20)

How Red Hat Uses FDO in Device Lifecycle _ Costin and Vitaliy at Red Hat.pdf
How Red Hat Uses FDO in Device Lifecycle _ Costin and Vitaliy at Red Hat.pdfHow Red Hat Uses FDO in Device Lifecycle _ Costin and Vitaliy at Red Hat.pdf
How Red Hat Uses FDO in Device Lifecycle _ Costin and Vitaliy at Red Hat.pdf
 
Choosing the Right FDO Deployment Model for Your Application _ Geoffrey at In...
Choosing the Right FDO Deployment Model for Your Application _ Geoffrey at In...Choosing the Right FDO Deployment Model for Your Application _ Geoffrey at In...
Choosing the Right FDO Deployment Model for Your Application _ Geoffrey at In...
 
Hyatt driving innovation and exceptional customer experiences with FIDO passw...
Hyatt driving innovation and exceptional customer experiences with FIDO passw...Hyatt driving innovation and exceptional customer experiences with FIDO passw...
Hyatt driving innovation and exceptional customer experiences with FIDO passw...
 
Harnessing Passkeys in the Battle Against AI-Powered Cyber Threats.pptx
Harnessing Passkeys in the Battle Against AI-Powered Cyber Threats.pptxHarnessing Passkeys in the Battle Against AI-Powered Cyber Threats.pptx
Harnessing Passkeys in the Battle Against AI-Powered Cyber Threats.pptx
 
Linux Foundation Edge _ Overview of FDO Software Components _ Randy at Intel.pdf
Linux Foundation Edge _ Overview of FDO Software Components _ Randy at Intel.pdfLinux Foundation Edge _ Overview of FDO Software Components _ Randy at Intel.pdf
Linux Foundation Edge _ Overview of FDO Software Components _ Randy at Intel.pdf
 
WebAssembly is Key to Better LLM Performance
WebAssembly is Key to Better LLM PerformanceWebAssembly is Key to Better LLM Performance
WebAssembly is Key to Better LLM Performance
 
Human Expert Website Manual WCAG 2.0 2.1 2.2 Audit - Digital Accessibility Au...
Human Expert Website Manual WCAG 2.0 2.1 2.2 Audit - Digital Accessibility Au...Human Expert Website Manual WCAG 2.0 2.1 2.2 Audit - Digital Accessibility Au...
Human Expert Website Manual WCAG 2.0 2.1 2.2 Audit - Digital Accessibility Au...
 
ASRock Industrial FDO Solutions in Action for Industrial Edge AI _ Kenny at A...
ASRock Industrial FDO Solutions in Action for Industrial Edge AI _ Kenny at A...ASRock Industrial FDO Solutions in Action for Industrial Edge AI _ Kenny at A...
ASRock Industrial FDO Solutions in Action for Industrial Edge AI _ Kenny at A...
 
Working together SRE & Platform Engineering
Working together SRE & Platform EngineeringWorking together SRE & Platform Engineering
Working together SRE & Platform Engineering
 
Tales from a Passkey Provider Progress from Awareness to Implementation.pptx
Tales from a Passkey Provider  Progress from Awareness to Implementation.pptxTales from a Passkey Provider  Progress from Awareness to Implementation.pptx
Tales from a Passkey Provider Progress from Awareness to Implementation.pptx
 
Secure Zero Touch enabled Edge compute with Dell NativeEdge via FDO _ Brad at...
Secure Zero Touch enabled Edge compute with Dell NativeEdge via FDO _ Brad at...Secure Zero Touch enabled Edge compute with Dell NativeEdge via FDO _ Brad at...
Secure Zero Touch enabled Edge compute with Dell NativeEdge via FDO _ Brad at...
 
WebRTC and SIP not just audio and video @ OpenSIPS 2024
WebRTC and SIP not just audio and video @ OpenSIPS 2024WebRTC and SIP not just audio and video @ OpenSIPS 2024
WebRTC and SIP not just audio and video @ OpenSIPS 2024
 
Where to Learn More About FDO _ Richard at FIDO Alliance.pdf
Where to Learn More About FDO _ Richard at FIDO Alliance.pdfWhere to Learn More About FDO _ Richard at FIDO Alliance.pdf
Where to Learn More About FDO _ Richard at FIDO Alliance.pdf
 
Extensible Python: Robustness through Addition - PyCon 2024
Extensible Python: Robustness through Addition - PyCon 2024Extensible Python: Robustness through Addition - PyCon 2024
Extensible Python: Robustness through Addition - PyCon 2024
 
Event-Driven Architecture Masterclass: Integrating Distributed Data Stores Ac...
Event-Driven Architecture Masterclass: Integrating Distributed Data Stores Ac...Event-Driven Architecture Masterclass: Integrating Distributed Data Stores Ac...
Event-Driven Architecture Masterclass: Integrating Distributed Data Stores Ac...
 
How we scaled to 80K users by doing nothing!.pdf
How we scaled to 80K users by doing nothing!.pdfHow we scaled to 80K users by doing nothing!.pdf
How we scaled to 80K users by doing nothing!.pdf
 
Intro to Passkeys and the State of Passwordless.pptx
Intro to Passkeys and the State of Passwordless.pptxIntro to Passkeys and the State of Passwordless.pptx
Intro to Passkeys and the State of Passwordless.pptx
 
Google I/O Extended 2024 Warsaw
Google I/O Extended 2024 WarsawGoogle I/O Extended 2024 Warsaw
Google I/O Extended 2024 Warsaw
 
ADP Passwordless Journey Case Study.pptx
ADP Passwordless Journey Case Study.pptxADP Passwordless Journey Case Study.pptx
ADP Passwordless Journey Case Study.pptx
 
(Explainable) Data-Centric AI: what are you explaininhg, and to whom?
(Explainable) Data-Centric AI: what are you explaininhg, and to whom?(Explainable) Data-Centric AI: what are you explaininhg, and to whom?
(Explainable) Data-Centric AI: what are you explaininhg, and to whom?
 

Closs

  • 1. Don’t be afraid of DITA your people will love it  Professor Sissi Closs Hochschule Karlsruhe Comet Computer GmbH, Comet Communication GmbH © Comet Computer GmbH, Comet Communication GmbH
  • 2. Your people will love it  © Comet Computer GmbH, Comet Communication GmbH
  • 3. Benefits of using DITA  Dita supports topic-oriented structuring including typing and is a standard.  DITA expertise grows.  Knowledge of how to use DITA grows.  The tool landscape continues to grow. © Comet Computer GmbH, Comet Communication GmbH
  • 4. Challenges  How to start?  How to structure?  How to organize everything? © Comet Computer GmbH, Comet Communication GmbH
  • 5. How to start? start? Tech Doc Experts Others  Analyze Content  Categorize  Create topic type  Use predefined  templates / forms  Fill-in topics / templates templates Define information architectures © Comet Computer GmbH, Comet Communication GmbH
  • 6. How to start: Tech Doc Experts start: © Comet Computer GmbH, Comet Communication GmbH
  • 7. How to start: Others start: © Comet Computer GmbH, Comet Communication GmbH
  • 8. How to structure? structure? Tech Doc Experts Others         Explicitely tag content Create separate topics Use XML tools Make us of complete feature set Use only preselected tag subset Write content in context Use Wysiwyg tool (no tags) Use simple predefined constructs © Comet Computer GmbH, Comet Communication GmbH
  • 9. How to structure: Tech Doc Experts structure: © Comet Computer GmbH, Comet Communication GmbH
  • 10. How to structure: Others structure: Solution 1      Authors write in a well prepared Word template. VBA macro generates more complex structures. VBA macro generates XML (“simplified DITA”). XSLT generates DITA topics. FrameMaker plug-ins, e.g. for CMS connection, metadata retrieval and update © Comet Computer GmbH, Comet Communication GmbH
  • 11. How to structure: Others structure: Solution 2 1. 2. 3. 4. Authors write with basic “normal.dot” Word template VBA macro generates formatted Word document. Editors finalize this Word document. Tool chain as in solution 1:     VBA macro generates more complex structures VBA macro generates XML (“simplified DITA”) XSLT generates DITA topics FrameMaker plug-ins, e.g. for CMS connection, metadata retrieval and update © Comet Computer GmbH, Comet Communication GmbH
  • 12. Complete Tool Solutions Input DITA environment Publications © Comet Computer GmbH, Comet Communication GmbH
  • 13. Why people love it       Multiple output (epub format, word, pdf) in good output quality Easy content exchange, combination, and integration Fast results Documentation that looks more professional Less maintainance Not working isolated © Comet Computer GmbH, Comet Communication GmbH
  • 14. Questions?  Thank you for your attention www.comet.de © Comet Computer GmbH, Comet Communication GmbH