Category Archives: Workshop

DITA Roadmap 2017

by

DITA-Anwender Bodensee lädt ein

icon DITA-ABNach einem erfolgreichen ersten Jahr, präsentieren wir stolz und unter neuem Logo unseren Meetup-Kalender für 2017.

DITA-Musterprojekte schreiben, 22.02.2017

Unsere erste Aufgabe in 2017 lautet “DITA-Musterprojekte schreiben”.

Ziel: Dokumentation in DITA-XML-Struktur in verschiedenen Komplexitätsstufen schreiben und auf GitHub hochstellen.

Zeitraum: Feb. – Juli 2017

Warum wir das tun? Unsere Arbeit wird sowohl Redakteuren als Beispiel, als auch Beratern und Tools-Herstellern als Vergleich- oder Qualitätssicherung-Material kostenfrei zur Verfügung stellen.

Wir werden selber dabei mehr über DITA lernen und wir werden weitere Meetups darauf bauen.

Machen Sie mit!

DITA-OT Ausgaben selber anpassen, 22.03.2017

Bringen Sie Ihre DITA-Projekte und Layout-Anforderungen mit und lernen Sie in unseren Single-Source Publishing Tutorialien, wie man die Publikationen selber anpasst:

  • “Mein erstes DITA-OT Plug-in” Franz-Josef Knelangen zeigt wie man die PDF-Ausgaben des DITA-OT selbst anpasst und dass das alle Technikinteressierten mit XML- und DITA-Grundkenntnissen hinbekommen können.
  • “Ein Inhalt – verschiedenste Layouts” Markus Wiedenmeier demonstriert die Automatisierung verschiedener Layouts, z.B. durch die Automatischen Vorgabeseitenzuweisung in FrameMaker.

DITA-Projekte lokalisieren, 19.04.2017

Unsere zweite Aufgabe in 2017 lautet “DITA-Projekte übersetzungsgerecht schreiben”.

Ziel: Best Practice über Terminologie, Lokalisierung und XLIFF-Generierung der Dokumentation in DITA-XML-Struktur.

Zeitraum: April – Aug. 2017

Warum wir das tun? Im Rahmen dieses Projektes tauschen wir unsere Erfahrungen mit Terminologie, Übersetzung und XLIFF aus, wir recherchieren und sammeln bewehrte Praktiken, um diese mit der DITA-Community zu teilen.

Wir werden selber dabei mehr über DITA und Übersetzungsgerechtes Schreiben lernen und wir werden weitere Meetups darauf bauen.

Machen Sie mit!

DITA-Markdown Roundtrip, 24.05.2017

Unser Jubiläum feiern wir  mit dem Kick-Off eines Geek-Projektes: “DITA-Markdown Roundtrip”.

Ziel: Markdown-Texte mit DITA-Projekte bidirektional integrieren und mit GitHub versionieren

Zeitraum: Mai – November 2017

Warum wir das Tun? Kleine Teams arbeiten oft mit Markdown-Sourcen und GitHub-Versionierung. Wir möchten in Erfahrung bringen, wie man DITA Doku-Projekte mit weiteren Texten in den verschiedene Markup-Sprachen integrieren, versionieren und pflegen kann.

Ist Ihnen das Thema bekannt? Machen Sie mit!

“The Key must be free”, 21.06.2017

Indirekte Verlinkungen (Keys) sind bei Weitem das spannendste Thema in DITA-Projekten. Wir testen zusammen die verschiedenen Verlinkungsmethoden und vergleichen ihre Vorteile und Nachteile.
Bringt eure schwierigsten Projekte mit!

DITA-Tools Battle, 19.07.2017

Wir haben seit Februar an die DITA-Musterprojekte gearbeitet. Nun wird die Zeit, die verschiedenen DITA-Tools zur Probe zu stellen und zu zeigen, was es heisst, mit einem offenen Standard zu arbeiten: Unsere Musterprojekte soll man in allen Tools öffnen und publizieren können.

Tools für DITA-Lokalisierung und Terminologie, 23.08.2017

Seit April recherchieren wir bewehrte Praktiken zu “DITA-Projekte übersetzungsgerecht schreiben”. In unserem August-Workshop vergleichen wir die Umsetzung manchen Übersetzung- und Terminologie-Tools anhand von unseren DITA-Musterprojekte.

Sneak-Peek der Herbst-Konferenzen, 20.09.2017

Im Herbst nehmen wir immer an TD-Konferenzen teil, sei es als Teilnehmer, Aussteller oder Referenten. Deswegen benutzen wir unser September-Termin als Sneak-Peek (Kostprobe) unserer Beiträge und als Vorbereitung unserer Botschaft an der DITA-Community.

Top 10 DITA-Flops, 22.11.2017

Am “Buß- und Bettag” möchten wir darüber nachdenken, wie wir DITA gelernt haben, wie wir durch systematisches Ausprobieren und aus unseren eigenen (kleinen und großen) Fehlern gelernt haben.
Topic-orientiertes, semantisches Schreiben in der technischen Redaktion zu implementieren bedeutet Änderung, und Änderung ist… naja, ein schönes Chaos.

Die Meetup-Seite: DITA-Anwender Bodensee

Mit Intelligenten Informationen begeistern

by

So lautete das Schwerpunktthema der tekom-Frühjahrstagung 2016 in Berlin: „Die Nutzer mit Intelligenter Information begeistern“. Der Keynote-Vortrag von  Prof. Wolfgang Henseler hat das Publikum davon überzeugt, dass um User Experience 4.0 zu erzielen, Produkte und Dienstleistungen “den Menschen befähigen und entlasten müssen, ihn aber nicht entmündigen!”

An beiden Konferenztagen durfte ich den Workshop “Einführung eines DITA-Pilot-Projekts – planen, starten, testen!” moderieren. Vielen Dank an den 50 Teilnehmern fürs Mitmachen und für ihren wertvollen Fragen und Feedback.

Es gab noch mehr aus der DITA-Welt in Berlin. Zum Beispiel: Dr. Sven Leukert von SAP hat die DITA-Spezialisierung und die üblichen Missverständnisse darüber erklärt; Jang Graat hat uns personalisierte Informationen mit Sahnehäubchen serviert.

Standbesucher und FCT-Team

Besucher und Berater am FCT-Messestand

Meine Kollegen von FCT AG, sowie unsere Partner von CCS Solutions haben sich über die Standbesucher in Berlin gefreut und sind schon gespannt auf die Jahrestagung in Stuttgart.

Building a DITA pilot project

by

The DITA pilots were hard at work again at TCUK. We have discussed what changes may come with the DITA implementation, but also what should stay the same… if done properly, namely the research and planing phase of a documentation project. The four working groups designed personas and use cases for a specific product line, then drafted the documentation outline that formed the basis of their DITA project.

ditapilots

You can see the prezi I used for the first part of the workshop here:

workshop prezi

Click the image to open the Prezi slideshow

Once we had a documentation outline, we started a DITA skeleton project in oXygen XML Editor. It is called a skeleton project, because we started a simple ditamap, just by replicating the outline, without actually creating any topics. We just added symbolic topicref elements and inserted the titles from our outline in navtitle attributes. A skeleton map can even be published for review.

Thus the writers have the entire outline model in the ditamap from the beginning and would be ready to start creating topics and developing the content using the ditamap as guidance, then adding the actual topics to the map in href attributes. This approach can be applied not only to provide orientation while creating new topics and enhancing the model, but also to ensure consistency across documentation sets… at least until fancier project templates are in place.

In case you’d like to try out building a DITA skeleton project, you can download the tutorial as PDF file ico_PDF.

Happy DIT’ing! More entertaining TCUK keepsake from Glasgow coming soon.

Upcoming workshop: Building a DITA pilot project

by

One more month to go until TCUK 2015 in Glasgow. Have you booked your package yet?

While preparing for the three-hour workshop on Building a DITA pilot project, the sound of bagpipes is bringing Scotland closer, here in Germany. Can’t wait to meet TCUK delegates again and to host another DITA workshop.

You are considering migrating to DITA and would like to see a proof of concept, but don’t know where to start? Bring your laptop to the DITA Pilot workshop and you’ll see how quickly you can get started. We’ll just follow a few steps:
1. Design phase:
– Identify use cases and task analysis
– Outline the information model and its modules
– Set up the project structure

2. Production phase:
– Writing the topics and the map
– Publishing PDF and HTML
– Reviewing

It does not take long to be productive in DITA and to prove its value to your team. Take a running project back to the office with you and turn the DITA business case into reality with a demo for your colleagues.

September 29, 2015, 2:00 pm to 5:00 pm
The Beardmore Hotel and Conference Centre, Hall: Clyde
TCUK Website: http://technicalcommunicationuk.com/

DITA Pilots, on your marks…

DITA linking best practice at IEn2015

by

Infomedian of the YearThe three days at Information Energy 2015 in Utrecht have passed too quickly. Everyone seemed to feel at home, the sessions were interactive and fun, speakers and attendants eager to share information and show how they create and publish content in most diverse forms and channels… that’s what makes an infomedian. To round up the experience, apart from teaching a master class and giving a presentation, I had the honor of giving a short interview and being part of the jury in one of the workshops.

Seats2Meet
The venue also gave it special “energy” – first, Master Classes and presentations at Uni Utrecht, a historical site with classical and retro chambers where the eyes of scientists, professors and artists watched us from old paintings or billboards, followed by workshops at Seats2Meet, a very interesting concept with themed lounges in vintage look.

After the full-day Master Class on the pre-conference day, I also gave a short presentation the next day about DITA Linking Best Practice. We have seen examples and done exercises in the workshop. We have also talked about structured, topic-oriented writing and about DITA architecture: map structure, reuse strategy, authoring environment and publishing pipelines. The presentation afterwards was just the shorthand version of the workshop, but it served to start further discussions. Thank you all for attending! It was great meeting everyone in Utrecht.

Enjoy the prezi and let me know your thoughts:

DITA Linking - prezi

Click the image to open the Prezi slideshow

For the advanced use of keys on topic references, don’t miss the contributions of Gnostyx and Eliot Kimber to the dita-community repository: dita-demo-content-collection

So how are you managing your content linking?

Related posts 😉