Additional Source Control Guidelines for Projects and Editors
There are a number of guidelines that projects and editors should adhere to in order to support source control.
Guidelines
Your project or editor should also do the following to support source control:
Area |
Project |
Editor |
Details |
|---|---|---|---|
Private copies of files |
X |
|
The environment supports private copies of files. That is, each person enlisted in the project has his/her own private copy of the files in that project. |
ANSI/Unicode persistence |
X |
X |
If you write the persistence code, persist files in the ANSI form because most source control programs do not currently support Unicode. |
Enumerate files |
X |
|
The project must contain a specific list of all files within it and must be able to enumerate the list of files using the IVsSccProject2 or GetProperty (VSH_PROPID_First_Child/Next_Sibling). The project should also expose item names through its GetMkDocument implementation and support name lookup (including special files) through its IsDocumentInProject implementation. |
Text format |
X |
X |
When possible, files should be in text format to support the merging of different versions. Files that are not in text format cannot be merged with other versions of the file later on. The preferred text format is XML. |
Reference-based |
X |
|
Reference-based projects are readily supported in source control. However, directory-based projects are also supported by source control as long as the project can produce a list of its files on demand, regardless of whether those files exist on disk. When opening a project from source control, the project file is brought down first before any of its files. |
Persist objects and Properties in predictable order |
X |
X |
Persist your files in a predictable order, such as alphabetical order, to facilitate merging. |
Reload |
X |
X |
When a file changes on disk, your editor must be able to reload it. When you participate in source control, the environment will reload data for you by calling your ReloadDocData implementation. The most difficult reload case is when a checkout occurs when you have called IVsQueryEditQuerySave::QueryEditFiles and are processing information. However, your reload code must be able to run in this situation. The environment automatically reloads project files. However, a project must implement IVsPersistHierarchyItem2 if it has nested hierarchies in order to support reloading nested project files. |