CADD: What can DITA learn from CAD?

CADD: Computer-CADD: Computer-Aided Documentation Aided Documentation DesignDesignWhat can DITA learn from CAD ?

Jang F.M. GraatJang F.M. Graat

WhoWho’’s talking ?s talking ?

Jang F.M. GraatJang F.M. Graat

Part-time DITA userPart-time DITA user

Full-time philosopherFull-time philosopher

25+ years Technical 25+ years Technical CommunicatorCommunicator

10+ years in machine 10+ years in machine manufacturing manufacturing domaindomain

Automating Adobe Automating Adobe FrameMakerFrameMaker

IBM did not invent reuseIBM did not invent reuse

Strict design rulesStrict design rules

3D CAD : visual 3D CAD : visual feedbackfeedback

3D CAD : HYDIHYM3D CAD : HYDIHYM

3D CAD : assembling 3D CAD : assembling partsparts

make partmake part

virtual partvirtual part

virtual partvirtual part

assemblyassembly

stock partstock part

Product : assembly Product : assembly hierarchyhierarchy

carcarcarcar

bodybodybodybody chassischassischassischassis controlscontrolscontrolscontrols

axleaxleaxleaxleframeframeframeframe wheelwheelwheelwheel engineengineengineengine

shaftshaftshaftshaft bearingbearingbearingbearing flangeflangeflangeflange

Item : information hubItem : information hub

item IDitem IDitem IDitem ID

item IDitem IDitem IDitem ID item IDitem IDitem IDitem ID item IDitem IDitem IDitem ID

partspartspartsparts

ERPERPERPERP

CADCADCADCAD

2D2D2D2D

3D3D3D3D

VRMLVRMLVRMLVRML

CAMCAMCAMCAM

finishingfinishingfinishingfinishing

productionproductionproductionproduction

materialmaterialmaterialmaterial

stockstockstockstock logisticslogisticslogisticslogistics manpowermanpowermanpowermanpower where where usedused

where where usedused

Reinventing the wheel ?Reinventing the wheel ?

Reuse is everywhereReuse is everywhere

Reusable componentsReusable components

item Aitem Atemptemp

item Aitem Atemptemp

item Aitem Atemptemp

item Aitem Atemptemp

item Aitem Atemptemp

item Aitem Atemptemp

item Aitem Atemptemp

item Aitem Atemptemp

item Aitem Atemptemp

item Aitem Atemptemp

item Aitem Atemptemp

item Aitem Atemptemp

Managing changesManaging changes

ServerServerServerServer

item Aitem Arelease 1release 1

item Aitem Arelease 1release 1

item Aitem Arelease 1release 1

item Aitem Arelease 1release 1

CAD CAD workstationworkstation

ss

CAD CAD workstationworkstation

ss

Supervisor Supervisor workstationworkstationSupervisor Supervisor workstationworkstation

item Aitem Arelease 2release 2

item Aitem Arelease 2release 2

item Aitem Arelease 2release 2

item Aitem Arelease 2release 2

useuse

check outcheck out

check incheck in

check outcheck out

useuse

releaserelease

item Aitem Arelease 1release 1

item Aitem Arelease 1release 1

Changing an item Changing an item versionversion

carcarcarcar

bodybodybodybody chassischassischassischassis controlscontrolscontrolscontrols

axleaxleaxleaxleframeframeframeframe wheelwheelwheelwheel engineengineengineengine

shaftshaftshaftshaft bearingbearingbearingbearing flangeflangeflangeflangebearingbearingbearingbearing

axleaxleaxleaxle

chassischassischassischassis

carcarcarcar

frameframeframeframe

shaftshaftshaftshaft

wheelwheelwheelwheel

bodybodybodybody

otherothercarscarsotherothercarscars

Change impacts Change impacts everythingeverything

item IDitem IDitem IDitem ID

item IDitem IDitem IDitem ID item IDitem IDitem IDitem ID item IDitem IDitem IDitem ID

partspartspartsparts

ERPERPERPERP

CADCADCADCAD

2D2D2D2D

3D3D3D3D

VRMLVRMLVRMLVRML

CAMCAMCAMCAM

finishingfinishingfinishingfinishing

productionproductionproductionproduction

materialmaterialmaterialmaterial

stockstockstockstock logisticslogisticslogisticslogistics manpowermanpowermanpowermanpower where where usedused

where where usedused

FFF : Form Fit FunctionFFF : Form Fit Function

FFF : pragmatic FFF : pragmatic solutionssolutions

axle 1axle 1axle 1axle 1

shaft 1shaft 1shaft 1shaft 1 bearing 1bearing 1bearing 1bearing 1 flange 1flange 1flange 1flange 1bearing 2bearing 2bearing 2bearing 2

axle 2axle 2axle 2axle 2

shaft 2shaft 2shaft 2shaft 2 flange 2flange 2flange 2flange 2

Minimizing change Minimizing change impactimpact

car 1car 1car 1car 1

body 1body 1body 1body 1 chassis 1chassis 1chassis 1chassis 1 controls 1controls 1controls 1controls 1

frame 1frame 1frame 1frame 1 wheel 1wheel 1wheel 1wheel 1 engine engine 11

engine engine 11

axle 2axle 2axle 2axle 2

Optimized productionOptimized production

All parts must be All parts must be availableavailable

Product : assembly Product : assembly hierarchyhierarchy

carcarcarcar

bodybodybodybody chassischassischassischassis controlscontrolscontrolscontrols

axleaxleaxleaxleframeframeframeframe wheelwheelwheelwheel engineengineengineengine

shaftshaftshaftshaft bearingbearingbearingbearing flangeflangeflangeflange

BOM : Bill Of MaterialsBOM : Bill Of Materials

BOM : basis for BOM : basis for productionproduction

item IDitem IDitem IDitem ID

item IDitem IDitem IDitem ID item IDitem IDitem IDitem ID item IDitem IDitem IDitem ID

partspartspartsparts

ERPERPERPERP

CADCADCADCAD

2D2D2D2D

3D3D3D3D

VRMLVRMLVRMLVRML

CAMCAMCAMCAM

finishingfinishingfinishingfinishing

productionproductionproductionproduction

materialmaterialmaterialmaterial

stockstockstockstock logisticslogisticslogisticslogistics manpowermanpowermanpowermanpower where where usedused

where where usedused

How we create manualsHow we create manuals

DITA : hierarchy of mapsDITA : hierarchy of maps

car.ditamapcar.ditamap

body.ditamapbody.ditamap

chassis.ditamapchassis.ditamap

frame.ditaframe.dita

axle.ditaaxle.dita

wheel.ditawheel.dita

CMS : chaos CMS : chaos managementmanagement

item IDitem IDitem IDitem ID

topicrefstopicrefstopicrefstopicrefs maprefsmaprefsmaprefsmaprefs conrefsconrefsconrefsconrefs

referencesreferencesreferencesreferences

where usedwhere usedwhere usedwhere used

DITAVALDITAVALDITAVALDITAVAL

mapsmapsmapsmaps conrefsconrefsconrefsconrefs xrefsxrefsxrefsxrefs

hrefshrefshrefshrefs

hrefshrefshrefshrefs

topic 1topic 1topic 1topic 1topic 2topic 2topic 2topic 2

conref 1conref 1conref 1conref 1 xref 1xref 1xref 1xref 1 href 1href 1href 1href 1xref 2xref 2xref 2xref 2conref 2conref 2conref 2conref 2 href 2href 2href 2href 2

topic 2topic 2topic 2topic 2

CMS : change CMS : change managementmanagement

map 1map 1map 1map 1

submap 1submap 1submap 1submap 1 submap 1submap 1submap 1submap 1 submap 1submap 1submap 1submap 1

topic 1topic 1topic 1topic 1 topic 1topic 1topic 1topic 1 topic 1topic 1topic 1topic 1

CADD : content CADD : content productionproduction

item IDitem IDitem IDitem ID

item IDitem IDitem IDitem ID item IDitem IDitem IDitem ID item IDitem IDitem IDitem ID

partspartspartsparts

ERPERPERPERP

CADCADCADCAD

2D2D2D2D

3D3D3D3D

VRMLVRMLVRMLVRML

CAMCAMCAMCAM

finishingfinishingfinishingfinishing

productionproductionproductionproduction

materialmaterialmaterialmaterial

stockstockstockstock logisticslogisticslogisticslogistics manpowermanpowermanpowermanpower where where usedused

where where usedused

DocDocDocDoc

trouble-trouble-shootingshootingtrouble-trouble-shootingshooting

taskstaskstaskstasks

specsspecsspecsspecs

BOM : Basis Of ManualsBOM : Basis Of Manuals

Questions, reactions ?Questions, reactions ?

Jang F.M. GraatJang F.M. Graat

JANG JANG CommunicationCommunication

Amsterdam, NLAmsterdam, NL

jang@jang.nl

www.jang.nl