|
|
(93 intermediate revisions by 9 users not shown) |
Line 1: |
Line 1: |
− | __NOTOC__
| + | ;Specification Project |
− | | + | : wiki home: [[Specification]] |
− | = OpenOffice.org Specifications =
| + | : ooo home: http://specs.openoffice.org/ |
− | Welcome to the web based collaboration area of the [http://specs.openoffice.org OpenOffice.org Specification Project].
| + | [[Category:Project]] |
− | Specifications are an essential part of the OpenOffice.org development process. They serve as working base for Development, [[User Experience]], Quality Assurance and Documentation.
| + | |
− | <br>
| + | |
− | <br>
| + | |
− | | + | |
− | | + | |
− | * Currently UI specifications are stored on [http://specs.openoffice.org UI Specifications for OpenOffice.org 2.0.x]
| + | |
− | * Older specifications can be found on [http://ui.openoffice.org/proposals/index.html UI Specifications for OpenOffice.org 1.1.x]
| + | |
− | <br>
| + | |
− | | + | |
− | == When do I have to Write a Specification for OpenOffice.org? ==
| + | |
− | | + | |
− | A specification needs to be written if at least one of the following questions can be answered with YES.
| + | |
− | | + | |
− | * Will the change cause a '''medium''' or '''major''' user interface modification?
| + | |
− | ** (Examples here)
| + | |
− | | + | |
− | * Will the changes modify the configuration settings of OpenOffice.org in any way?
| + | |
− | ** (Examples here)
| + | |
− | | + | |
− | * Will the changes modify the installation process or the installer configuration of OpenOffice.org in any way?
| + | |
− | ** (Examples here)
| + | |
− | | + | |
− | * Will the changes modify the API of OpenOffice.org in any way?
| + | |
− | ** (Examples here)
| + | |
− | | + | |
− | | + | |
− | A specification needs '''NOT''' to be written if:
| + | |
− | | + | |
− | * The changes causes a '''minor''' user interface modification.
| + | |
− | ** (Examples here)
| + | |
− | | + | |
− | * The changes are not going to be integrated into the OpenOffice.org master.
| + | |
− | ** (Examples here)
| + | |
− | | + | |
− | * The change is an Add-on which is distributed separately.
| + | |
− | ** (Examples here)
| + | |
− | <br>
| + | |
− | == I Want to Write a Specification, Tell me How Can I Start? ==
| + | |
− | | + | |
− | We think that writing a specification should be as painless as possible that's why we have created a [http://specs.openoffice.org/collaterals/template/OpenOffice-org-Specification-Template.ott specification template]. This template simplifies the process of writing specifications and the best reduces the time to review specifications.
| + | |
− | | + | |
− | * Please use the official [[Image:ott.png]] [http://specs.openoffice.org/collaterals/template/OpenOffice-org-Specification-Template.ott OpenOffice.org Specification Template]
| + | |
− | '''Note:''' the template requires OpenOffice.org 2.02 or newer, make also sure that the OpenOffice.org proxy settings are configured correctly. They can be found under Tools/Options/Internet/Proxy.
| + | |
− | | + | |
− | After you have downloaded the [http://specs.openoffice.org/collaterals/template/OpenOffice-org-Specification-Template.ott specification template] check if all necessary pre-requisites for writing a specification are fulfilled. This avoids wasting resources and failures during the process of writing specifications.
| + | |
− | | + | |
− | If you can answer each of the following questions marked with the letter Q with 'Yes'? You can start writing.
| + | |
− | What happens if I don't have all the pre-requisites? Well, the consequence could be that your valuable work won't be integrated into OpenOffice.org.
| + | |
− | | + | |
− | === Q1 [Requirement]: ===
| + | |
− | Does a requirement, request for enhancement (RFE), or issue exist?
| + | |
− | | + | |
− | === Q2 [Concept]: ===
| + | |
− | Is a product concept available, which is understandable to the intended readership?
| + | |
− | | + | |
− | === Q3 [Project-Resources]:===
| + | |
− | 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 quality assurance member (required)
| + | |
− | * An user experience member (optional, but required if the feature or bug fix affects the user interface)
| + | |
− | | + | |
− | === Q4 [Implementation Team Agreement]: ===
| + | |
− | Do all project members agree on Q1 - Q3?
| + | |
− | | + | |
− | == "What Else do I Have to Follow?" ==
| + | |
− | It is strongly recommended to follow the [[The Three Golden Rules for Writing OpenOffice.org Specifications]]
| + | |