Your SlideShare is downloading. ×
Presentation20130616
Upcoming SlideShare
Loading in...5
×

Thanks for flagging this SlideShare!

Oops! An error has occurred.

×

Saving this for later?

Get the SlideShare app to save on your phone or tablet. Read anywhere, anytime - even offline.

Text the download link to your phone

Standard text messaging rates apply

Presentation20130616

125
views

Published on

Published in: Technology, Business

0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
125
On Slideshare
0
From Embeds
0
Number of Embeds
1
Actions
Shares
0
Downloads
3
Comments
0
Likes
0
Embeds 0
No embeds

Report content
Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
No notes for slide

Transcript

  • 1. © 2013 IBM CorporationUsing Distributed Version Control Systems:Enabling enterprise scale, XML basedinformation developmentAdrian Warman – IBM Information ArchitectJune 16th, 2013
  • 2. © 2013 IBM Corporation2Introduction Dr. Adrian R. WarmanInformation ArchitectIBM United Kingdom LimitedHursley ParkWinchesterHampshireSO21 2JNmail: Adrian.Warman@uk.ibm.comTwitter: @warmanaGoogle+: Adrian WarmanTel: +44-196-281-9176Disclaimer Any views or opinions expressed in thispresentation are those of the author, anddo not necessarily represent officialpositions, strategies or opinions ofInternational Business Machines (IBM)Corporation. No guarantees are offered as to thetimeliness, accuracy or validity ofinformation presented.
  • 3. © 2013 IBM Corporation3Definitions Information Development– Enterprise documentation characteristics Information Set– Information stream Darwinian Information Typing Architecture– XML Markup Distributed Version Control System
  • 4. © 2013 IBM Corporation4Workflow
  • 5. © 2013 IBM Corporation5Basic XML content creation using DITA<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE map PUBLIC"-//OASIS//DTD DITA Map//EN" "map.dtd"><map xml:lang="en-us"><title>Getting started</title><topicrefhref="quickstartguide/exploring-the-dita-ot.dita"collection-type="sequence"><topicrefhref="readme/installing-full-easy.dita"/><topicrefhref="quickstartguide/rundemo.dita"/><topicrefhref="quickstartguide/runmore.dita"/></topicref></map><?xml version="1.0" encoding="UTF-8"?><!DOCTYPE task PUBLIC"-//OASIS//DTD DITA Task//EN" "task.dtd"><task id="exploring-the-dita-ot"><title>Getting Started with the DITA OpenToolkit</title><shortdesc>The <ph><cite>Getting StartedGuide</cite></ph> is designed to provide aguided exploration of the DITA Open Toolkit.It is geared for an audience that has littleor no knowledge of build scripts or DITA-OTparameters. It walks the novice user throughinstalling the full-easy-install version ofthe toolkit and running a promptedbuild.</shortdesc></task>
  • 6. © 2013 IBM Corporation6DVCS Principles Contrast with VCS More than one person working on adocumentation set Storing versions of files in a repository Everyone has a complete copy of theentire repository Local changes can be shared Merging should be as automatic aspossible– But fail gracefully if necessary
  • 7. © 2013 IBM Corporation7Storage requirements for a local repository Subversion (VCS) Server copy of entire repository = 800+ MB Local copy of repository and snapshot= 1.6 GB Git (DVCS) Server copy of entire repository = 331 MB Local copy of repository and snapshot= 1 GB
  • 8. © 2013 IBM Corporation8Using a DVCS for multiple branches and multiple deliveries
  • 9. © 2013 IBM Corporation9Advantages and disadvantages Not a Content Management System (CMS) Mechanisms for ensuring validity of markup Re-use is possible– Simplified by branch merging? Assembly of content on demand Multi-branch management can become complex– Very complex Do local storage requirements scale? Going beyond intent of original DVCS concept Moving sub-content might be problematic
  • 10. © 2013 IBM Corporation10Summary, Q&A Basic characteristics of Enterprise documentation Similarity to Enterprise software development Application of DVCS solution to some challenging documentation tasks– Real-world success in several major documentation -restructuring and migrationtasks The investigation continues...