Customizing the metamodel : Diagrams: Creating and modifying : Creating roadmap-style diagrams : Diagram : How are Milestone symbols positioned and phases colored?
  
How are Milestone symbols positioned and phases colored?
Users are not allowed to reposition milestone symbols manually or to drag milestone definitions onto the diagram.
Instead, the positioning of the Milestones should be determined by (a) the date value for the Milestone and (b) the Time Scale chosen for the diagram.
The user controls the relative order of Milestone instances within a Project instance by controlling their dates.
Note This should have the effect of changing the position of the same Milestone (if used) in other such Diagrams.
Since every Milestone is owned by a specific Project, it will be possible to access the list of Milestones using a LISTOF property in the Project definition.
The label on a milestone is the concatenation of its name and its date.
All milestones should have a label.
A diagram property will control presentation of milestones and phases.
By default, projects are presented according to the milestones they contain, with the phase colors also defined by that project and the underlying milestones.
Users can select through a diagram property that projects show only milestones that are also contained by the topmost project. The phase colors are also defined by settings in the topmost project.
The intervals between Milestones represent phases of a specific Project and should be colored to enable different phases to be distinguished.
The Project Phase does not appear as a separate model item. However, it may be convenient to treat it as a symbol whose size, position and color attribute are assigned automatically based on the position of the Milestones at either end. There is no separate symbol type for the Phases. The Phases are simply drawn as part of the Project and the Milestones are always drawn afterwards. User Draw Order is not allowed on this diagram type.
The user may allocate the color of a phase.
Refer to above diagram property note.
If no color overrides have been set then the default colors will be used.
The color of a phase following a milestone is specified in the milestone definition.
A property in the project controls the color of the phase preceding the first milestone.
A diagram property will control how default phase colors are used, when not filtering project milestones and phases by the topmost project.
Colors will be picked purely by phase number order; the first phase drawn gets the first default color, the second phase gets the second default color, and so on. New and existing diagrams will be presented in this fashion unless the user changes the option.
The property allows users to reserve the first default color (pink) to be used only for the pre-first milestone color, when not filtering the projects by the topmost project on the diagram. The default value is F and existing diagrams are assumed to have the value F for this property.
An undefined project, or a project with no milestones, or a project with no milestones in the period of the timeline, will show a Pre-Post phase in the pre-first-milestone color set for the project, or the first default color if no color override is set.