migrating to dita_ flacke
TRANSCRIPT
![Page 1: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/1.jpg)
Integrating content? Minimalize, downsize and
make it DITA compliant!
Marie-Louise Flacke
Information DeveloperCongility Conference 2011, Crawley, UK
![Page 2: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/2.jpg)
What and how to integrate?
GIGO? Full content ?Copy & paste?
![Page 3: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/3.jpg)
.
Process
• Analyze
• Clean
• Re-write
• Test
• Hand-over
![Page 4: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/4.jpg)
.
Analyse legacy documents
• Find the tasks?
• Explicit topic titles?
• Acronyms defined ?
• Graphics quality?
• Text about text?
![Page 5: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/5.jpg)
Start Cleaning(1) Decorum
• Eliminate frames
• Eliminate unnecessary graphics (screenshots, pictograms, icons)
(2) Pompous Text • Eliminate Text about text
• Eliminate general generalization (About, introduction, overview… )
![Page 6: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/6.jpg)
Start Cleaning(3) Glue
• Stem sentences
• Prepositions/adverbs/adjectives
(4) Useless signs• Warnings
• Notes
![Page 7: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/7.jpg)
Cleaning: don‘t insult(5) … User‘s intelligence !
This is a warning sign!
![Page 8: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/8.jpg)
Objective: DITA
Legacy documentation
DITA compliant?
![Page 9: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/9.jpg)
Task vs. Useless title
7.1 Voice recording playback
![Page 10: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/10.jpg)
Task: Sort the trash!
7.1 Voice recording playback
![Page 11: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/11.jpg)
Task = title
<TITLE> Changing the scanner settings
<TITLE> Setting up a different scanner
<TITLE> Testing and repairing a scanner
![Page 12: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/12.jpg)
Define Acronyms!
• ATM?
• Air-Traffic Management• Asynchronous Transfer Mode• Automatic Teller Machine• … what else ?
![Page 13: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/13.jpg)
Redundant graphic?
![Page 14: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/14.jpg)
Screenshots
![Page 15: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/15.jpg)
Pictograms, logos…
![Page 16: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/16.jpg)
Stem sentences
• To introduce the steps in a task - steps won’t correctly start renumbering with 1)
(J.Hackos)
• Do We Really Need All that Glue? - transitional text, advance organizers, text between topics ?
(J. Hackos, DITA.xml.org)
![Page 17: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/17.jpg)
.
Text about text
![Page 18: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/18.jpg)
Getting more and more DITA compliant…
![Page 19: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/19.jpg)
Organize!
![Page 20: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/20.jpg)
![Page 21: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/21.jpg)
Warning = instructions
Cleaning the oxygen tubes
Make sure the oxygen tubes are fully clean.Oxygen, oil or grease make an explosive mixture.
1. Select the Maxi-brush 2. Perform a first cleaning with the Maxi-Brush 3. With the pressure-cleaner, perform a 2nd cleaning.
![Page 22: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/22.jpg)
Stop playing with warning signs!
![Page 23: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/23.jpg)
Even more DITA compliant…
![Page 24: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/24.jpg)
Start Re-design/Re-design• Pertinent titles
• based on tasks
• Terminology & acronyms•Consistent, user-focused and… Controlled (English)
• Standardized procedures
•Convert notes & warnings in instructions
![Page 25: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/25.jpg)
Minimalism
• Garbage-free • Structured• Optimized (for migration)• Re-usable
![Page 26: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/26.jpg)
Title, warning, note?
![Page 27: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/27.jpg)
![Page 28: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/28.jpg)
Title?
Note?
Grouping?
![Page 29: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/29.jpg)
1.1 Run the Eclipse and CDT installation for WindowsThe CDT software is required if you are developing in C and/or C++, but not for Java development.
1. Download the appropriate Windows version of Eclipse Ganymede from the site XXX2. Download the CDT software:
(a.1) Download the appropriate CDT version from the Site ZZZ(a.2) Follow the installation instructions on the site-or-(b.1) Inside Eclipse, select Help-->Software updates (b.2) Under the Available Software tab, select the appropriate CDT versioin(b.3) Follow the Eclipse installation instructions.
1.2 Add the language compilers • Select the compilers for the language/languages you are using.
1.3.Install the Rational Rhapsody Developer for C and/or C++
Eclipse and CDT (continued)
![Page 30: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/30.jpg)
Entering text
1. Start programming with the TM/ST key2. Press the job code number3. Press the XYZ key.
The cash register is ready for text entry
![Page 31: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/31.jpg)
DITA ready: Hand-over to the migration team!
Documentation volume – 50%
Localization costs – 80%
High re-use rate
![Page 32: Migrating to dita_ flacke](https://reader031.vdocuments.net/reader031/viewer/2022022412/58f2cb511a28ab2f5e8b459b/html5/thumbnails/32.jpg)
Tel. : +33 9 75 75 40 20 GSM: +33 6 03 20 50 10
Contact : flacke[at]orange.fr
minimalist-doc.blogspot.com