svn commit: r14028 - trunk/documentation/cookbook

Author: mvw
Date: 2008-01-07 14:13:55-0800
New Revision: 14028

Modified:
   trunk/documentation/cookbook/changelog.xml
   trunk/documentation/cookbook/require.xml

Log:
Describe the results from a discussion on the dev list.

See also issue 4960.

Modified: trunk/documentation/cookbook/changelog.xml
Url: http://argouml.tigris.org/source/browse/argouml/trunk/documentation/cookbook/changelog.xml?view=diff&rev=14028&p1=trunk/documentation/cookbook/changelog.xml&p2=trunk/documentation/cookbook/changelog.xml&r1=14027&r2=14028
==============================================================================
--- trunk/documentation/cookbook/changelog.xml	(original)
+++ trunk/documentation/cookbook/changelog.xml	2008-01-07 14:13:55-0800
@@ -55,7 +55,7 @@
 
       <tbody valign="top">
         <row>
-          <entry>2007-01-</entry>
+          <entry>2008-01-</entry>
           <entry>
 Change to XXX.
 (See <xref linkend="xxx"/>).
@@ -67,6 +67,17 @@
 
       <tbody valign="top">
         <row>
+          <entry>2008-01-07</entry>
+          <entry>
+            Added requirement about enforcement of well-formedness rules.
+            (See <xref linkend="REQ15"/>).
+          </entry>
+          <entry>Michiel van der Wulp</entry>
+        </row>
+      </tbody>
+
+      <tbody valign="top">
+        <row>
           <entry>2007-01-16</entry>
           <entry>
 Change to the definition of the subsystem.

Modified: trunk/documentation/cookbook/require.xml
Url: http://argouml.tigris.org/source/browse/argouml/trunk/documentation/cookbook/require.xml?view=diff&rev=14028&p1=trunk/documentation/cookbook/require.xml&p2=trunk/documentation/cookbook/require.xml&r1=14027&r2=14028
==============================================================================
--- trunk/documentation/cookbook/require.xml	(original)
+++ trunk/documentation/cookbook/require.xml	2008-01-07 14:13:55-0800
@@ -312,6 +312,39 @@
 </para>
 
     </sect2>
+    <sect2 id="REQ15">
+      <title>
+        About enforcement of well-formedness rules from the UML standard.
+      </title>
+      <para>
+        REQ15 REVa
+      </para>
+      <para>
+        WFR = Well-Formedness Rule. This matter was discussed in
+        the dev list, in the thread following
+        "http://argouml.tigris.org/servlets/ReadMsg?list=dev&amp;msgNo=20622".
+      </para><para>
+        1. Critics shall warn for any WFR violations 
+        (a critic for every WFR would be ideal).
+      </para><para>
+        2. Generally, ArgoUML shall not enforce WFRs, except in certain cases.
+      </para><para>
+        3. In such cases (where we enforce a WFR) we shall
+      </para><para>
+        a. document this case, and
+      </para><para>
+        b. be consistent about it.
+      </para><para>
+        4. Even if a WFR is enforced, ArgoUML shall still be able 
+        to deal with a model that breaks it.
+        <emphasis>Rationale:</emphasis> 
+        since we can load a XMI that breaks the WFR.
+      </para>
+      <para>
+        <emphasis>Stakeholder:</emphasis>
+        User of ArgoUML
+      </para>
+    </sect2>
   </sect1>
 
   <sect1>