ECONDEC-80: Improve decision knowledge documentation

Author: kleebaum

de.uhd.ifi.se.decision.management.eclipse/src/de/uhd/ifi/se/decision/management/eclipse/view/ChangeImpactAnalysisView.java

@@ -10,19 +10,19 @@
 
 /**
  * @issue How to present related knowledge and change impact to developers?
- * @decision Present related knowledge and change impact in dedicated views.
  * @alternative Present related knowledge and change impact as a list of
  *              proposals.
  * @con Would mislead developers. Developers associate content assist with
  *      auto-completion and proposals for bug-fixes.
+ * @decision Present related knowledge and change impact in dedicated views!
  * 
  * @issue How to trigger decision exploration and change impact analysis?
- * @decision Use menu items in context menu to trigger decision exploration and
- *           change impact analysis!
  * @alternative Content assist invocation triggers decision exploration view and
  *              change impact analysis view
  * @con Would mislead developers. Developers associate content assist with
  *      auto-completion and proposals for bug-fixes.
+ * @decision Use menu items in context menu to trigger decision exploration and
+ *           change impact analysis!
  */
 public class ChangeImpactAnalysisView extends ViewPart {
 

de.uhd.ifi.se.decision.management.eclipse/src/de/uhd/ifi/se/decision/management/eclipse/view/PropertyPage.java

@@ -20,9 +20,10 @@
  * @see ConfigPersistenceManager
  * @see PreferencePage
  * 
- * @issue Currently, only the preferences are used. The project properties are
- *        treated the same as the preferences. How can we access the project
- *        properties in the ConfigPersistenceManager class?
+ * @issue Currently, only the preferences are used (thus, all Eclipse projects
+ *        have the same settings). The project properties are treated the same
+ *        as the preferences. How can we access the project properties in the
+ *        ConfigPersistenceManager class?
  */
 public class PropertyPage extends org.eclipse.ui.dialogs.PropertyPage implements IWorkbenchPropertyPage {
 	private Text textGitPath;