SVN merging documentation branches

Subject: SVN merging documentation branches
From: Karen Felker <akaren -at- earthlink -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Wed, 16 May 2012 17:12:45 -0700

Our DITA documentation is under SVN control. We use the <ph> element with combinations of at least 15 product tags to organize shared content. Historically, we have maintained all documentation in one documentation trunk, even though the engineers may have many code branches for several different software product releases. When they build the software, they include the documentation trunk.

Recently, the engineers have begun working on two sequential releases of one product at the same time. Some engineers have suggested we branch our documentation to avoid content screw-ups. If they are on schedule, always a big IF, at lease a month should separate the releases.

When we tried something like this about two years ago, the SVN merge did not catch all the changes made inside <ph> element tags. Instead of branching docs, I'd almost prefer writing up doc changes for the later release in Word, and getting them reviewed, then adding them to the DITA files at the last minute.

Does anyone have experience with similar branching and merging of DITA-based docs? If so, have you run into any problems like this?

Karen Felker
akaren -at- earthlink -dot- net

A bus station is where a bus stops. A train station is where a train stops. On my desk, I have a work station.









^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help. Choose your authoring formats and get any output you may need.

Try Doc-To-Help, now with MS SharePoint integration, free for 30-days.

http://bit.ly/doc-to-help

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Follow-Ups:

Previous by Author: Re: Words That Are Often Misused
Next by Author: tech writing recruiters
Previous by Thread: Re: TIP - PDFs from Word show inserted image filenames (uponmouseover)
Next by Thread: RE: SVN merging documentation branches


What this post helpful? Share it with friends and colleagues:

Sponsored Ads


Sponsored Ads