Revision as of 09:35, 22 January 2013

Evolution Specification: Enhance readability of the structural differences

Current status is DRAFT

The difference labels displayed in the structure merge viewer can be quite difficult to read and understand.

_Relevant tickets_ (links to the Bugzilla tickets which are related to the change):

Add some styling to these label to more easily identify:

For this purpose, styled texts will be used in the label provider.

Here is the new version of the labels:

On each node, the data displayed are: object_name [property_affected type_of_difference]

The object name: the object concerned by the difference (e.g. class, attribute, reference...)
The property affected: the property of the object concerned by the difference.
The type of difference: the type of difference found on the property affected (e.g. add, remove, delete, set, unset, move or change)

@@ Line 31: / Line 31: @@
 * The property affected: the property of the object concerned by the difference.
 * The type of difference: the type of difference found on the property affected (e.g. add, remove, delete, set, unset, move or change)
-== Backward Compatibility and Migration Paths  ==
-=== Metamodel Changes  ===
-This evolution does not change the metamodel.
-=== API Changes  ===
-TODO.
-(List every API addition, removal and deprecation. For each removal and deprecation, indicate the migration path for existing code.)
-=== User Interface Changes  ===
-TODO.
-(List every user-visible change in the interface. Here "user" includes not only end-users but also developpers.)
-=== Documentation Changes  ===
-TODO.
-(List every documentation needing an update here, starting by the New and Noteworthy documentation.)
-== Tests and Non-regression strategy  ==
-TODO.
-(This part of the document should describe the strategy to use to correctly test the evolution and guarantee the non-regression.)
-== Implementation choices and tradeoffs  ==
-TODO.
-(Any important tradeoff or choice made during the implementation should be referenced here with pros/cons leading to the final decision.)
 [[Category:EMF Compare]]