|
|
| (46 intermediate revisions by 9 users not shown) |
| Line 1: |
Line 1: |
| − | | + | ;Specification Project |
| − | = OpenOffice.org Specifications =
| + | : wiki home: [[Specification]] |
| − | Welcome to the web based collaboration area of the [http://specs.openoffice.org OpenOffice.org Specification Project].
| + | : ooo home: http://specs.openoffice.org/ |
| − | | + | [[Category:Project]] |
| − | | + | |
| − | Specifications are an essential part of the OpenOffice.org development process. Changes to OpenOffice.org be it adding new feature or enhancing existing ones will be done based on written specifications. This is absolutely neccessary as there are always multiple persons or groups involved in a change to OpeOffice.org.
| + | |
| − | Specifically specifications serve as working base for:
| + | |
| − | | + | |
| − | | + | |
| − | '''Development (DEV)
| + | |
| − | DEV implements features based on the technical information covered in specifications.
| + | |
| − | | + | |
| − | '''[[User Experience]] (UX)
| + | |
| − | UX uses specifications to define the user interface (UI) and its interaction model.
| + | |
| − | | + | |
| − | '''[http://qa.openoffice.org/ Quality Assurance] (QA)
| + | |
| − | QA derives Test Case Specifications based on specifications. They test implemented features against the specifications.
| + | |
| − | | + | |
| − | '''Documentation (DOCU)
| + | |
| − | DOCU writes the end-user documentation based on specifications.
| + | |
| − | | + | |
| − | <br>
| + | |
| − | There is a [http://specs.openoffice.org/collaterals/template/OpenOffice-org-Specification-Template.ott '''Specification Template'''] which greatly simplifies the process of writing specifications and which helps to avoid the common errors usually leading to rework, regressions and delays.
| + | |
| − | <br>
| + | |
| − | | + | |
| − | | + | |
| − | | + | |
| − | == I Want to Change Something in OpenOffice.org - Do I Have to Write a Specification? ==
| + | |
| − | | + | |
| − | | + | |
| − | '''In general the answer is YES. This applies to:'''
| + | |
| − | | + | |
| − | * [http://www.openoffice.org/scdocs/ddIssues_EnterModify.html#issuetype Features]
| + | |
| − | * [http://www.openoffice.org/scdocs/ddIssues_EnterModify.html#issuetype Enhancements]
| + | |
| − | * [http://www.openoffice.org/scdocs/ddIssues_EnterModify.html#issuetype Defects] requiring the following type of changes:
| + | |
| − | ** Behavioral changes of the UI (e.g. changing a dialog from modal to modeless)
| + | |
| − | ** Visual changes of the UI (e.g. changing the icon size, the splash screen, the about box)
| + | |
| − | ** Configuration changes (e.g. changing application defaults such as Spellchecking ON/OFF)
| + | |
| − | * Features, enhancements, defects which are already covered by an [http://specs.openoffice.org/ existing specification].
| + | |
| − | | + | |
| − | | + | |
| − | '''A specification needs NOT to be written if:'''
| + | |
| − | | + | |
| − | You do the following kind of changes:
| + | |
| − | * Fixing a typo in the UI.
| + | |
| − | * Rearranging UI controls without changing functionality.
| + | |
| − | * The changes are not going to be integrated into the OpenOffice.org master.
| + | |
| − | ** The change is an Extension which is distributed separately to OpenOffice.org
| + | |
| − | | + | |
| − | | + | |
| − | '''If you are in doubt''', whether you need a specification or not ask the responsible project lead of the corresponding application (see table below).
| + | |
| − | | + | |
| − | {| border="0" cellpadding="3" width="50%" valign="top"
| + | |
| − | | + | |
| − | |- align="left"
| + | |
| − | | style="background-color: #efefef; width: 30%" | '''Application'''
| + | |
| − | | style="background-color: #efefef; width: 70%" | '''Project Lead'''
| + | |
| − | |-
| + | |
| − | | Writer || '''Andreas Martens''' mailto:Andreas.Martens@sun.com
| + | |
| − | |-
| + | |
| − | | Calc|| '''Niklas Nebel''' mailto:Niklas.Nebel@sun.com
| + | |
| − | |-
| + | |
| − | | Drawing|| '''Kai Ahrens''' mailto:Kai.Ahrens@sun.com
| + | |
| − | |-
| + | |
| − | | Impress|| '''Christian Lippka''' mailto:Christian.Lippka@sun.com
| + | |
| − | |-
| + | |
| − | | Database|| '''Frank Schoenheit''' mailto:Frank.Schoenheit@Sun.com
| + | |
| − | |-
| + | |
| − | | Math|| '''Mathias Bauer''' mailto:Mathias.Bauer@sun.com
| + | |
| − | |-
| + | |
| − | | Chart|| '''Kai Ahrens''' mailto:Kai.Ahrens@sun.com
| + | |
| − | |-
| + | |
| − | | Framework|| '''Mathias Bauer''' mailto:Mathias.Bauer@sun.com
| + | |
| − | |-
| + | |
| − | | Other|| '''Martin Hollmichel''' mailto:Martin.Hollmichel@sun.com
| + | |
| − | |}
| + | |
| − | <br>
| + | |
| − | <br>
| + | |
| − | <br>
| + | |
| − | | + | |
| − | == Before Writing a Specification -- What Else Do I have to Do? ==
| + | |
| − | You should be able to answer each of the following questions marked with the letter Q with '''YES''':
| + | |
| − | | + | |
| − | | + | |
| − | '''Q1 [Feature/Enhancement]:'''<br>
| + | |
| − | Does an unambiguously clear feature or enhancement request exists?
| + | |
| − | | + | |
| − | | + | |
| − | '''Q2 [Concept]:'''<br>
| + | |
| − | For changes requiring modifications in more than one application: Is there a product concept available, which is understandable to the intended readership?
| + | |
| − | | + | |
| − | | + | |
| − | '''Q3 [Project-Resources]:'''<br>
| + | |
| − | Do you have a project team?
| + | |
| − | An OpenOffice.org feature is always being devoloped by an Implementation Team (i-Team). An i-Team consists at least of two distinct persons:
| + | |
| − | * A developer '''(required)'''
| + | |
| − | * A QA representative '''(required)'''<br>Ask for a QA representative in the mailto:dev@qa.openoffice.org mailing list.
| + | |
| − | * An [http://wiki.services.openoffice.org/wiki/OpenOffice.org_User_Experience_Community User Experience] member ('''optional, but required''' if the feature or bug fix affects the user interface or the behavior of the application)
| + | |
| − | | + | |
| − | | + | |
| − | '''Q4 [i-Team Agreement]:'''<br>
| + | |
| − | Do all i-Team members agree on Q1 - Q3?
| + | |
| − | | + | |
| − | | + | |
| − | '''What happens if I can't answer all questions mentioned above, with Yes?'''<br>
| + | |
| − | The consequence could be that your valuable work won't be integrated into OpenOffice.org.
| + | |
| − | <br>
| + | |
| − | <br>
| + | |
| − | | + | |
| − | == Write a Specification, Tell me How Can I Start? ==
| + | |
| − | | + | |
| − | OpenOffice.org specifications are being developed on the following iterative process:
| + | |
| − | | + | |
| − | * '''Plan'''<br>
| + | |
| − | ** I-Team Kickoff
| + | |
| − | ** Detailed feature / sub-feature planning
| + | |
| − | ** First design sessions
| + | |
| − | | + | |
| − | | + | |
| − | * '''Do'''<br>
| + | |
| − | ** Create prototypes/first implementation
| + | |
| − | ** Write specification
| + | |
| − | | + | |
| − | | + | |
| − | * '''Review'''<br>
| + | |
| − | ** i-Team reviews specification based on three essential rules<br>
| + | |
| − | | + | |
| − | R1:[http://wiki.services.openoffice.org/wiki/The_Three_Golden_Rules_for_Writing_OpenOffice.org_Specifications Complete]<br>
| + | |
| − | R1:[http://wiki.services.openoffice.org/wiki/The_Three_Golden_Rules_for_Writing_OpenOffice.org_Specifications Clear]<br>
| + | |
| − | R1:[http://wiki.services.openoffice.org/wiki/The_Three_Golden_Rules_for_Writing_OpenOffice.org_Specifications Simple]<br>
| + | |
| − | | + | |
| − | | + | |
| − | * '''Improve'''<br>
| + | |
| − | ** Reduction of defects in specification
| + | |
| − | ** Reduction of defects in implementation
| + | |
| − | | + | |
| − | | + | |
| − | More details on the process can be found [http://specs.openoffice.org/collaterals/presentations/Specification-Template-Presentation.odp here]
| + | |
| − | | + | |
| − | | + | |
| − | OpenOffice.org specifications are bases on a template.
| + | |
| − | '''Use this official [[Image:ott.png]] [http://specs.openoffice.org/collaterals/template/OpenOffice-org-Specification-Template.ott OpenOffice.org Specification Template]''', it assists you writing a specification.<br>
| + | |
| − | | + | |
| − | '''Note:''' the template requires OpenOffice.org 2.02 or newer, make sure that the OpenOffice.org proxy settings are configured correctly. The proxy settings can be changed under Tools/Options/Internet/Proxy.
| + | |
| − | | + | |
| − | == Process Exit here ==
| + | |
| − | | + | |
| − | == What Else do I Have to Follow? ==
| + | |
| − | * It is strongly recommended to follow the [[The Three Golden Rules for Writing OpenOffice.org Specifications]]
| + | |
| − | | + | |
| − | * If need to do a compatitive analyses please follow the [[Guidelines for Accomplishing a Competitive Analysis on Feature Level]]
| + | |
| − | | + | |
| − | * Specifications for OpenOffice.org 2.0.x can be found on the [http://specs.openoffice.org UI Specifications for OpenOffice.org 2.0.x] site
| + | |
| − | | + | |
| − | * Older Specifications can be found in the section [http://ui.openoffice.org/proposals/index.html UI Specifications for OpenOffice.org 1.1.x]
| + | |
| − | <br>
| + | |
| − | | + | |
| − | == Feedback and comments ==
| + | |
| − | Feedback or comments are welcome please feel free to submit them to "dev at specs dot openoffice dot org"
| + | |
