About diagram promotion

Promoting a diagram will create a master copy of the diagram. Only authorized diagrams can be promoted and once promoted, the draft copy is locked to prevent further editing. Only draft promoters can promote drafts and they come in two forms; map draft promoters can promote an entire map whilst diagram draft promoters can promote a specific diagram and all lower levels.

By default, a diagram and all child diagrams need to be promoted in one operation since the diagram is a hierarchical structure and the child diagrams define the parent diagram. However, it is possible to promote only the parent diagram without the child diagrams.

The top-level diagram of a promotion operation has to have a corresponding diagram in the master with the same underlying ID in order to undertake the promotion (except in the case of the level 1 diagram for the first time where the master does not exist). If the IDs do not match then it means a fundamental restructuring of the draft diagrams has occurred since the last promotion. In this case a promotion should be performed from a higher level. However, it is possible to resynchronize the IDs in the draft map to match the IDs in the master, which can be useful if new sections of the map have been imported.

The draft promotion process will begin at the current diagram and include all lower level diagrams. If the entire map is ready to be promoted then the process must be initiated at level 1. All promoted diagrams will then be locked in draft mode and must be unlocked to make any edits. Placeholders will be created in the master for any child diagrams that are not being promoted, therefore when the child diagrams are promoted the relationship between parent and child diagrams will be restored.