Accessibility
Matthew Ellison

Matthew Ellison

www.ellisonconsulting.com

Table of Contents

Created:
15 January 2007
Modified:
22 October 2007
User Level:
All
Products:
robohelp

Getting started with RoboSource Control 3

Adobe RoboSource Control 3 is an optional application that ships with Adobe RoboHelp 7.  It enables you to store all the files from a RoboHelp project in a server-based database (this process is called "adding the project to version control").  These project files may then be copied to one or more other client PCs allowing members of an authoring team to view and work on the same project simultaneously.

RoboSource Control 3 manages all the changes to the files by enforcing a system of "checking out" and "checking in" files.  An author must check out a file from the database before being able to make any changes to the file in RoboHelp —the process of checking out retrieves the latest version of the file from the database and flags the file as being checked out.  The check out system has the advantage of enabling you to prevent two members of the team from making changes to the same file simultaneously. RoboHelp HTML handles the check in and check out operations for you automatically—you may check in RoboHelp for Word project files manually using the RoboSource Control Explorer application.

RoboSource Control 3 consists of the following two separate components.

  • RoboSource Control 3 Client: this provides the software that enables RoboHelp to get, check out, and check in the project files in the server-based RoboSource Control database. It also includes RoboSource Control Explorer, a separate application that enables you manage the database files, create users, and assign access rights.
  • RoboSource Control 3 Server: this is the central server software that stores and manages files in a database. It supports checking files in and out, viewing the history of files, setting up users and associated access rights, and many other useful version control operations. Unlike previous versions, RoboSource Control 3 Server is based on SQL Server.

RoboHelp 7 also integrates with Microsoft Visual SourceSafe or any other third-party version control package that supports the Microsoft Source Code Control API (sometimes called the SCC API). Therefore you may be able to use RoboHelp 7 with your existing version control package as an alternative to installing RoboSource Control 3.

Throughout the remainder of this article, I will use the general term RoboSource Control 3 to refer to the entire version control system (consisting of both client and server components), and the full names of RoboSource Control 3 Client and RoboSource Control 3 Server to refer to each of the components.

Requirements

In order to make the most of this article, you need the following software and files:

RoboHelp 7

RoboSource Control 3

 

About the author

Company Director Matthew Ellison has 20 years of experience as a user assistance and eLearning professional in the software industry. Much of this time was spent managing a team of writers and trainers at a UK-based consulting company, before enjoying a period in the U.S. as Director of the WinWriters (now WritersUA) Conference.

Matthew has a B.Sc. in Electronic Engineering and a Post-Graduate Certificate of Education from Bristol University in the UK. He is an Adobe Certified Instructor, and is also a Certified Instructor for WebWorks ePublisher Pro.

Matthew has been a popular speaker at conferences and training events throughout the world since 1997, and has covered a diverse range of topics from context-sensitive Help to the Spice Girls. He also regularly publishes articles and reviews on user assistance tools and technology.