Changes between Version 14 and Version 15 of GLOBAL_SPEC_STRUCTURE_R1

Timestamp:

01/10/09 13:38:06 (16 years ago)

Author:

kyli

Comment:

--

GLOBAL_SPEC_STRUCTURE_R1

@@ -33 +33 @@
  * Revise the current table in [wiki:GLOBAL_SPEC_STRUCTURE]:
   * Change the diagrams link: [svn://sophie2.org/sophie2/trunk/sophie2-platform/doc/spec-diagrams]
-  * Add user documentation, which is also a specification artifact
-  * Decide if it is needed to copy the artifacts with "not available" links from the old repository to the new one and link them in the document
-  * Decide what to do with the idea for a [wiki:SPEC_INDEX] document (see the previous revision of this task). Will this document be used, which task should fill the document, etc.
-  * Discuss whether to replace the table with a structured text - this way a longer descriptions/explanations could be made without affecting the good look of the document.
+  * Fix the "not available" links: the folders must be linked with their path in the repository, and the missing documents must be copied from the old repository and linked.
+  * We need a specification for the user documentation - its structure, its content. So, link the user_doc tasks until now, which have analyses (the analyses are actually specifications).
+  * Replace the table with a structured text (or several smaller tables - which is better) - this way longer descriptions/explanations could be made without affecting the good look of the document.
  * Revise the google spreadsheet:
-  * decide whether to split the different objects into different sheets (for example menus, tabs, etc) - with the growing of the specifications it might become unreadable. 
   * Make a better outlook of the document - the tree structure is not good; the column descriptions could be in brackets, after column names.
   * Discuss the name of the spreadsheet - sophie2-gui-elements is not correct, since it contains DND table, too. A better name would be "sophie2-user-interactions"
   * Discuss where to put the extra functionalities of user interaction: keyboard shortcuts, mouse gestures (for example, a table "extra" in the spreadsheet). Discuss also whether these will be available: for example, F1 should invoke the user help.
+  * Discuss what extra behavior from Sophie1 is expected.
   * Updating information on the current tables is part of another task.
- * All discussions' result would be better to be stored in the existing [wiki:GLOBAL_SPEC_STRUCTURE] and applied to the corresponding documents.
+ * All discussions' results would be better to be stored in the existing [wiki:GLOBAL_SPEC_STRUCTURE] and applied to the corresponding documents.
 
 = Implementation =