Changes between Version 5 and Version 6 of CODE_TASKS_REQUIREMENTS

Timestamp:

09/26/08 11:47:00 (17 years ago)

Author:

peko

Comment:

--

CODE_TASKS_REQUIREMENTS

@@ -217 +217 @@
 }}}
 file shall be declared private.
+
+= Name Conventions Common Mistakes =
+ * Avoid non descriptive names
+
+A name should be clear enough to suggest what the thing is given the local context. For example:
+
+{{{
+private static final int FRAME_CORRECTION_POSITION = 20;
+}}}
+is not clear in the context of the class Frame. It may be more clear in the context of the frameDropped() method, but here it is not. A better name would be
+{{{
+private static final int FRAME_DROP_OFFSET = 20;
+}}}
+
+ * Avoid inaccurate names
+