Configuring Your System

Before you can start using Code Co-op, you have to configure it for collaboration. You have to tell it whether you are the first person to use it, or if you're joining a team of developers who are already using Code Co-op. You also have to specify how you want your computer to communicate with others (e-mail or LAN).

When you are ready to configure Code Co-op follow this link. But first read on...

E-mail Configuration

The simplest and most common configuration is E-mail Peer. As an e-mail peer, your Code Co-op will communicate with other Code Co-op project members using e-mail. You'd be surprised how fast e-mail communication could be. The advantage of e-mail over direct Internet connection (peer-to-peer) is that e-mail servers can store messages. So even if two computers are never on-line at the same time, they can still exchange messages.

Code Co-op dispatcher may use Outlook or Outlook Express as its e-mail client (using MAPI protocol). A better solution is to use the Dispatcher's built-in e-mail client, which communicates with the e-mail server directly (using SMTP/POP3 protocol). If you don't have a dedicated e-mail account for Code Co-op, you can use a free Gmail account instead.

LAN Configuration

Collaboration over a Local Area Network is available only in the version Pro of Code Co-op. On a LAN, you have to designate one computer as a Hub. This doesn't have to be a server, it can be any machine that is on most of the time. All other Code Co-op machines on the LAN must be configured as Satellites.

All Code Co-op exchanges within the Local Area Network pass through the Hub. You can also configure the Hub to use e-mail to communicate with the external world. The external world could be e-mail peers, or other remote Hubs. For instance, portable laptops are usually configured as e-mail peers, so they can connect to a project from anywhere.

Disconnected Operation

Once you join collaboration on a Code Co-op project, your computer will contain a full replica of the project database: all of its files including their history. You can check files out and modify them even if you are not connected to the Internet. You only need the connection when you are ready to check your changes in.

Next: Configuration Wizard >


Working with Code Co-op

Code Co-op is a full-function version constrol system. It lets you modify project files, keeps track of all versions, and makes your changes visible to other collaborators.

Code Co-op tries to keep the impression of a single development line, with interleaved contributions from all collaborators. It keeps branching and merging to the very minimum (although it offers full support for these operations).

Starting a Project

Each Code Co-op project appears as a directory (or a tree of directories) on your disk. If you already have files that form a development project, you can start a Code Co-op project in place. Or you can start an empty project and add files (and subdirectories) later.

Joining a Collaboration

You can join an existing Code Co-op project, either by asking the project administrator to send you an Invitation, or by sending a Join Request to any project member.

Next: Starting and Joining Projects >


Working with Project Files

The minimal development cycle in Code Co-op consists of three stages:

You may accept changes from other project members at any time--they arrive as soon as other members make their check-ins. If the changes modify some of the files you are currently editing, the built-in merger performs the merges. You have to accept all pending changes before making your check-in.

Next: Working with files >


Starting Code Co-op


Co-op icon Dispatcher icon

After setup, you should see this icon on your desktop--the shortcut to Code Co-op. Double-click on it to start the program. Also notice the dispatcher icon on the taskbar.