Overview

Welcome to the Sublime User Guide. This guide describes how to use Sublime as a user. It covers repository creation, repository management, how to find repositories you have access to, managing permissions, etc.

This guide does NOT cover working with Subversion. For an excellent guide to working with Subversion, check out the Subversion Book, or if you are a TortoiseSVN user, the TortoiseSVN manual is a great resource for getting started.

The Basics

Before we dig into the details, let’s cover a few of the basic ideas behind Sublime.

Repository Creation

By default, all users of Sublime will have the ability to create a new repository. This is intentional. Our opinion is that it is better to have source code in a managed, subversion repository than no repository at all - even if the code has to be moved somewhere else in the future. However, this is configurable and it may be disabled for your organization.

Repository Meta-data

If we allow anybody to create a repository, then we need to know more about it than just a name. We need to know who created it, when it was created, and maybe even a description. Sublime captures these details automatically.

Repository Owner

Each repository has an owner. Repository owners have full control over their repositories and can manage security, turn email notifications on or off, etc. This takes the management job out of the hands of IT, and places it in the hands of someone close to each project. This greatly reduces the IT bottleneck and ensures developers get the proper access quickly and securely.

Repository Templates

Again, if we’re letting anybody create repositories we need to ensure that there is some consistency in terms of repository structure and content. A new user may not realize that they should create branches, tags, and trunk folders. That’s where Repository Templates come in.

Repository templates are pre-defined repository structures and content that you can choose from when creating a new repository. Not only do they make the creation process easy and fast, but they help you enforce policies and re-use starting project structures and/or content across your organization.