Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column
Document Properties Marker
overridefalse
Short DescriptionFixing 86 issues since version 2.4.
Doctyperelease-notehide
Nameprojectdoc Toolbox 2.5 Release Notes
Short Name
Parent
Parent Property
property-nameName
hide
Audience
Name List
doctyperole
render-no-hits-as-blanktrue
propertyAudience
empty-as-nonetrue

Subject
Name List
doctypesubject
propertySubject

Categories
Name List
doctypecategory
propertyCategories

Tags
Tag List
propertyTags

Iteration

Iteration
valueproduction

hide
Type
Name List
doctyperelease-note-type
render-no-hits-as-blanktrue
propertyType

Version2.5.1hide
Productprojectdoc Toolboxhide
Release Date
hide
Sponsors
Name List
doctypestakeholder
render-no-hits-as-blanktrue
propertySponsors

Sort Key00002.00005.00001hide
Section
show-titlefalse
titleDescription

Today we released version 

Display Property
property-nameVersion
of the projectdoc Toolbox on the Atlassian Marketplace!

This release provides some new features, improvements of existing features, and fixes a number issues.

Panel
borderColordarkgrey
borderWidth2

The projectdoc Toolbox is an add-on for Confluence supporting agile software development teams to collaborate on process, project, system, and product documentation. 

Transclusion
documentHOMESPACE:projectdoc Video Link
idsprojectdoc

Info Box

Download the projectdoc Toolbox or visit the projectdoc Toolbox on the Atlassian Marketplace!

Column
width350px
Panel
titleRelease Notes Overview

Table of Contents
indent15px
excludeRelease Notes|Description|Summary|"References"|Resources
stylenone

...

Section
titleNew and Noteworthy
Section
titleCheck Property Value

With this version it is possible to show a section or content dependent on a property value.

Code Block
languagetext
property-name=my-value,!property-name2=other-value

Prior to this version hiding has been only possible on the presence or absence of a property.

Section
titleFlags Property

All document types now provide an additional hidden property to add arbitrary strings. These strings are Flags and are used to filter document.

In contrast to Subject, Categories, and Tags, Flags are not defined by their own document type (therefore are not documented) and will not be used to describe the HTML document with metadata-setsMetadata Sets.

Section
titleWiki Syntax

Selected macros from the projectdoc Toolbox can now be used with wiki syntax. This allows to use these macros with Confluence, where the new macros are not allowed (such as the menu).

Section
titleUpdated Doctypes

The references and resources section use the Tour Macro by default. This makes it much easier for authors to add references to internal pages and show their short description.

The table is rendered as a definition list. So if the link in the first column of the table is an external link, and no short description is provided, the definition list supports a compact representation by omitting the data value.

Section
titleDeveloper Diaries use Templates

Some developer diaries doctypes now use the template feature with the Display Table Macro. This allows to render the Iteration property compactly with the Short Description.

Section
titleLayout Macros

The projectdoc Toolbox provides macros for layouting web pages.

These include:

Tour
render-as-definition-listtrue
header-translationsName=Macro
replace-title-with-nametrue
Section
titleBreaking Changes
Section
titleNew Blueprint IDs

For all doctype add-on updates to their model version the blueprint keys change. This will effect the Create From Template Macro on existing pages.

This issue needs to either be resolved manually or by a text replacement tool.

Only the value for the blueprintModuleCompleteKey parameter of the macro needs to be replaced.

Code Block
<ac:parameter ac:name="blueprintModuleCompleteKey">
  de.smartics.atlassian.confluence.smartics-projectdoc-confluence-space-swdev:projectdoc-blueprint-doctype-architecture-decision
</ac:parameter>

The new key prefix (excluding the name of the doctype) for the Software Development Doctypes Add-on is

Code Block
de.smartics.atlassian.confluence.smartics-projectdoc-confluence-space-swdev:projectdoc-blueprint-doctype-

To update the value a user with write access may simply change the value in the macro editor of the Create From Template Macro:

Image Added

If you do not want to scroll through long lists of blueprints, you may use the Source Code Editor and do the text replacement in the page source.

Section
titleReindex required

In order to fix broken phantom references (due to

Jira
serversmartics JIRA
serverId79ad43bc-d289-364e-bfc7-46c09847bebd
keyPDAC-922
), a reindex is required.

Section
titleDoctype Add-ons
intro-textDoctype add-ons provide space and page blueprints based on the projectdoc Toolbox.
Expand
titleDetails on add-ons ...
Section
titleprojectdoc Core Doctypes

List of breaking changes in this add-on.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution
maximumIssues20
jqlQueryproject = 'projectdoc Core Doctypes' AND resolution = Fixed AND fixVersion = 11.1.0 AND "Break" in (api, deprecated, removed, runtime, "runtime (fix with reindex)") ORDER BY priority DESC, updated DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd

Section
titleprojectdoc Add-on for arc42

List of breaking changes in this add-on.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution
maximumIssues20
jqlQueryproject = 'projectdoc Add-on for arc42' AND resolution = Fixed AND fixVersion = 7.0.0 AND "Break" in (api, deprecated, removed, runtime, "runtime (fix with reindex)") ORDER BY priority DESC, updated DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd

...