Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Document Properties Marker
doctypemacro
overridefalse
Doctypemacrohide
NameIteration Macro 
Short DescriptionSelects an iteration phase from a fixed set of stages. 
Parent
Parent Property
property-nameName
 
Audience
Name List
doctyperole
render-no-hits-as-blanktrue
render-list-as-comma-separated-valuestrue
namesAuthor, Template Author
 
Categories
Name List
doctypecategory
render-no-hits-as-blanktrue
namesDocument / Development, Selection
 
Tags
Tag List
namesSelect, Collaboration
 
Iteration
Iteration
valueproduction
hide
Sort Keyhide
Section
indextrue
titleDescription

The iteration property is a tool for the author to communicate the status of the document within its creation process. Readers get aware, what to expect from a given document.

Section
titleProperties

The macro provides only one property to select the iteration value.

Section
idstages

The stages of the document development process are as follows:

Iteration
valuefacade
The document has just been added with basic information. This is the skeleton of a document, ready to be referenced by other documents.
Iteration
valuefilled
Information has been searched and accumulated to reach the breadth of the document. Every idea is added and may or may not contribute to the final version of the document. This is like adding topics to a mind map to expand to the full potential of the document.
Iteration
valuefocused
Pruning and selecting relevant information and giving it more structure. This removes the ideas generated by the previous stage that do not fit nicely. They may be moved to other documents, merged with other sections of the same document or discarded.
Iteration
valuefinished
The document is ready to be used (but may be enhanced in future versions).
Iteration
valuereleased
The document has been released for internal use. This will communicate to team members that the contents of the document and the implications on the team's process have been agreed on.
Iteration
valueproduction
The document has been released for third party use. This makes it visible to team members that this document had been made available to others.
Iteration
valuedeprecated
The document has been used formerly, but is no longer supported. The end-of-live of its use has been started to be finally removed.
Iteration
valueremoved
The document has been removed and has no relevance for the project any longer. Removed documents are still found in the attic for future reference. The reasons for the removal should be added to the document's notes.
Section
titleDetails

If you start a new stage, change the value of the iteration property. So after you have created the document in the facade stage and you start to add additional information, set the stage to filled, until you decide you have aggregated enough. Then switch to focused to start the pruning process. If you are satisfied, tag the document as finished. If it is discussed by the team and accepted, move it to released. As soon as it is ready for delivery to third parties, tag it as production.

Once you decide the information is no longer valid in near future, signal this state by entering the deprecated state. If it is no longer valid, the document finally arrived in the end state removed.

Caution Box

Please notice that the first three states define a stage within the process the document is in, while the other states actually define a state the document has already achieved.

The first four stages are based on

Cite
template$[Name] (${Authors})
documentPDAC:Kulak2000
. The authors defines those stages to iteratively develop use cases. But we think those stages also help to create documents of any type.

...

Section
titleReferences

Section
titleResources

 

Piwik Set Multiple Custom Variables
NameValue
Departmentprojectdoc
Categoryprojectdoc-macro
Typeworkflow