wiki:PLATFORM_STANDARDS_GENERAL

Version 8 (modified by deyan, 17 years ago) (diff)

--

Tasks results

Each task should have a wiki page which should contain one or more of the following result types:

Result Types

  • Specification (produced in the analysis phase of each task) or link to specification in following format:

!== Specification ==
[wiki:PAGE]

  • a link to development document (produced in the design phase). Can also be the final result of a task. This should be in following format:

!== Development Document == [source:/path/filename] path here should be changed when format of development documents is chosen

  • Diagrams (one or more, usually as a part of a specification or development document). These should be inserted in section Diagrams

!== Diagrams ==

  • Diagrams should be stored in the repository, at their proper place.
    • trunk\sophie2-platform\doc\spec-diagrams
    • trunk\sophie2-platform\doc\dev-doc-diagrams
  • Each diagram should be exported to PNG format with the same name as it's original format. Original format should be kept so the diagram can be edited later.
  • Diagrams should be included in the wiki page by inserting
    • [[Image(source:/trunk/sophie2-platform/doc/spec-diagrams/image.png)]] for specification diagrams
    • [[Image(source:/trunk/sophie2-platform/doc/dev-doc-diagrams/image.png)]] for dev-doc diagrams.

Example:

Specification ==

This section contains specification text.

==Develompent document==

path/filename1
path/filename1

==Source==

path/filename

==Diagrams==

source:/trunk/sophie2-platform/doc/spec-diagrams/AboutDialog.png
source:/trunk/sophie2-platform/doc/spec-diagrams/AboutDialog.png

" [source:filename]" (Preview:filename) [Image:filename] [source:filename]

# a how-to (usually as a part of a development document)

  • Source code (produced in the implement phase of most tasks). Files should be linked by [source:/path/filename] in the following section:

==Source== # a review (done after each phase). This decides whether the task can proceed to the next phase.