driving dita off the map

25
Driving DITA off the Map Jang F.M. Graat

Upload: jang-fm-graat

Post on 18-Nov-2014

192 views

Category:

Technology


0 download

DESCRIPTION

Publications in DITA are handled via dita maps. Even with conditions and DITAVAL options, these are inherently static and bound to an old book type paradigm. In this presentation I am trying to outline a new paradigm, where the disclosure of information is made truly dynamic. Doing away with maps or at least with one single top-level map that defines all content. Having a dynamic information disclosure layer in place may prepare our technical content for the fast-moving world of today (which will move even faster tomorrow).

TRANSCRIPT

Page 1: Driving DITA off the Map

Driving DITA off the Map

Jang F.M. Graat

Page 2: Driving DITA off the Map

Who’s talking ?• Jang F.M. Graat

• Amsterdam

• Part-time tech comms specialist (25+ years)

• Full-time philosopher

• Box ? What box ?

• Addicted to challenge

Page 3: Driving DITA off the Map

Driving DITA off the Map

Toward (Much) More Intelligent Information Disclosure

Page 4: Driving DITA off the Map

What’s the problem ?

Page 5: Driving DITA off the Map

Minimalism

Page 6: Driving DITA off the Map

Only what the user needs

Page 7: Driving DITA off the Map

One Size Fits All ?

Page 8: Driving DITA off the Map

Who is the user ?

Page 9: Driving DITA off the Map

What do they know ?

Page 10: Driving DITA off the Map

Progressive disclosure

Page 11: Driving DITA off the Map

Workflow diagram

Page 12: Driving DITA off the Map

Trouble-shooting

Page 13: Driving DITA off the Map

Organizing topics

Page 14: Driving DITA off the Map

Where to look ?

Page 15: Driving DITA off the Map

Outdated paradigm

Page 16: Driving DITA off the Map

Slightly better paradigm

Page 17: Driving DITA off the Map

Modern (lazy) paradigm

Page 18: Driving DITA off the Map

What is installed ?

A B C D E F G H

GUI a X X X X

GUI b X X X

GUI c X X

library 1 X X X

library 2 X X X X X X

library 3 X X X X

.NET X X X X

SQL X X X

PHP X X X X

Page 19: Driving DITA off the Map

Can users figure it out ?

Page 20: Driving DITA off the Map

User-side configuration

Page 21: Driving DITA off the Map

Intelligent disclosure

information elements (multiple versions)

maps, indexes, cross-refs, search results

product a product b product c

Page 22: Driving DITA off the Map

c X

X

X

Dynamic toc, index, etc.

information elements (multiple versions)

a b

Page 23: Driving DITA off the Map

Dynamic topic linking

information elements (multiple versions)

a b c

Page 24: Driving DITA off the Map

Only what users need

Page 25: Driving DITA off the Map

Questions ?

jang @ jang . nl