Design document

From Species File Help
(Difference between revisions)
Jump to: navigation, search
(Exporting a Jira Design Document)
 
Line 13: Line 13:
 
== Exporting a Jira Design Document ==
 
== Exporting a Jira Design Document ==
  
Jira design documents can be exported for review outside the web by using the views option.  
+
Jira design documents can be exported for review outside the web-interface by using the views option to create a Word (or other) document. These can be sent to collaborators for further review/comments.
  
 
[[File:Issue2Word.PNG]]
 
[[File:Issue2Word.PNG]]
  
 
[[Category:Developers]]
 
[[Category:Developers]]

Latest revision as of 11:55, 20 August 2012

A design document is a tool used within the context of SFS development. It is largely used as an internal tool for communicating detailed ideas about the formal structure and function of potential changes to the SFS software and website. It is used at various stages in the development process. Initially it can be used to set out proposed ideas and later as a guide of work yet to be done.

[edit] Creating a new Design Document

To create a new Design Document use the 'Design Document' issue type in Jira. You must at minimum provide some text in "Background".

[edit] Listing all existing Design Documents

Go to 'Issues'->'Favourite Filters' and select "All Design Documents in All Projects". If you do not see this filter click on 'Issues'->'Manage Filters' then select 'Search' on the left. Make sure the 'Shared with' dropdown says "anyone" and click search. Add the filter (or any other one) to your favourites by clicking the star.

AllDDs.PNG

[edit] Exporting a Jira Design Document

Jira design documents can be exported for review outside the web-interface by using the views option to create a Word (or other) document. These can be sent to collaborators for further review/comments.

Issue2Word.PNG

Personal tools
Namespaces

Variants
Actions
Navigation
Species Files
Wiki
Toolbox