Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section


Column


Document Properties Marker
overridefalse


Short DescriptionDoctype as a Parameter, improved Support for Attachments, plus more new features, improvements, and bugfixes.
Doctyperelease-notehide
Nameprojectdoc Toolbox 4.2 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

Version4.2hide
Productprojectdoc Toolboxhide
Release Date

Dec 2019 

hide
Sponsors
Name List
doctypestakeholder
render-no-hits-as-blanktrue
propertySponsors

Sort Key00004.00002.0000hide



Section
show-titlefalse
titleDescription

Today we released version 

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

This release provides new features, improvements, and bugfixes.

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
titleDoctype as a Parameter

A projectdoc Document demands a Name and a Doctype to be set. All other document properties are recommended, especially the Short Description, but are not necessary.

Since Nameless Documents the name of a projectdoc Document may be derived from the Title. Since the title is mandatory for a Confluence page, the only property still required being part of the table within the Document Properties Marker Macro was the Doctype.

The Doctype property's value also needed to be provided in plain text. The projectdoc Toolbox does not a macro here since the value is required before any property value resolvement takes place.

This version of the projectdoc Toolbox allows to specify the doctype as a parameter to the Document Properties Marker Macro. This way the property cannot be accidentally be removed or changed. Since the property is hardly ever changed, it will not take space in the editor, too.

Note that a property with name Doctype still overrides any value set with the macro parameter. This is to ensure backward compatibility. It is not meant to be a standard use case.

Here is an example showing the doctype 'todo' as part of the macro.

Image Added

When opening the macro in the editor, the Doctype parameter shows the type if the document.

Image Added


Section
titleImproved Attachment Support

The projectdoc Toolbox provides support to render the contents of an attached file. This allows template authors to design document types (blueprints) that show contents from files easily. From the moment a user attaches a document, the contents will automatically been shown.

Tour
header-translationsSuite=Add-on
replace-title-with-nametrue



The Attachment Link Macro makes it easy to reference an attachment as a property value. Use the Reference Attachment Code Block Placeholder Macro to render the attached file (or a part of the file) in a code box. In case there is no need to have the attached file as a property, use the Attachment Code Block Placeholder Macro.

The Autocomplete with this version also supports selecting attached files.


Section
titleLayouting transcluded Content

When a transclusion macro renders content, the layout may be affected. This is typically because the transcluded content is rendered inside a HTML div element. This way CSS selectors on first element may not be applied or (not applied) as expected.

The users now can add additional CSS rules by referencing the selector "projectdoc-transcluded-content" which is rendered with the transcluded content.


Section
titleRequired Properties for Rendering

The Section Macro and the Content Marker Macro allow to control the rendering dependent on the evaluation of document and space properties. Prior to this version all listed properties have to meet the constraints (i.e. they were ANDed). With this version authors can specify that at least one property must match (i.e. they are now ANDed or ORed).

Currently we do not support more sophisticated queries using AND and OR in one specification.



Section
titleBreaking Changes

This version has no breaking changes.

...

Section
titleUpgrade Instructions

Install the new OBR of the projectdoc Toolbox, then the extensions listed below. After that the doctype add-ons starting with Core.


Section
titleList of Changes

The following changes are part of the latest projectdoc Toolbox for Confluence

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'projectdoc Toolbox' && (fixVersion = '4.2.0') ORDER BY priority DESC, type DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd

...

Section
titleRelated Releases


Section
titleExtension Add-ons

The following extensions are required to be updated for the projectdoc Toolbox.

All extensions are optional. In case an extension is not installed, there is no need to install it for this version of the projectdoc Toolbox.

true
Section
hide
titleWeb API Extension

The following changes are part of the latest Web API Extension.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDEXWAPI' && (fixVersion = '6.12.0') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


true
Section
hide
titleBookmarklets Extension

The following changes are part of the latest Bookmarklets Extension.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDEXBML' && (fixVersion = '3.01.0') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


true
Section
hide
titleInformation Systems Extension

The following changes are part of the latest Information Systems Extension.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDEXINFOSY' && (fixVersion = '23.01.0') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
hidetrue
titleMaven Extension

The following changes are part of the latest Maven Extension.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDEXMVN' && (fixVersion = '5.0.1') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd



true
Section
hide
titleDoctype Add-ons

The following doctype add-ons are recommended to be updated for the projectdoc Toolbox.

All doctype add-ons are optional. In case an add-on is not installed, there is no need to install it for this version of the projectdoc Toolbox.

Section
titleCore Doctypes

The following changes are part of the latest Core Doctypes Add-on

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDCORED' && (fixVersion = '13.1.0.1') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
titleDoctypes for Agile Planning

The following changes are part of the latest Doctypes for Agile Planning.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDAGILE' && (fixVersion = '11.1.0.1') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
titleprojectdoc Developer Diaries

The following changes are part of the latest projectdoc Developer Diaries.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'DEVDIARY' && (fixVersion = '10.1.0.1') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
titleDoctypes for Project Management

The following changes are part of the latest Doctypes for Project Management.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDPRJMGMT' && (fixVersion = '5.1.0.1') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
hidetrue
titleDoctypes for Risk Management

The following changes are part of the latest Doctypes for Risk Management.

This extension is experimental.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDRISKMGMT' && (fixVersion = '3.0.0') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
titleDoctypes for Service Management

The following changes are part of the latest Doctypes for Service Management.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'SERVICES' && (fixVersion = '3.1.0.1') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
titleDoctypes for Business Strategy

The following changes are part of the latest Doctypes for Business Strategy.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'STRATEGY' && (fixVersion = '3.1.0.1') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
titleDoctypes for Software Development

The following changes are part of the latest Software Development Doctypes.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDSWDEVD' && (fixVersion = '11.1.0.1') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
titleDoctypes for Teamwork

The following changes are part of the latest Doctypes for Teamwork.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDTEAMWORK' && (fixVersion = '3.1.0.1') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
titleDoctypes for V-Modell XT

The following changes are part of the latest Doctypes for V-Modell XT.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDVMXT' && (fixVersion = '3.1.0.1') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
titleprojectdoc arc42 Template

The following changes are part of the latest projectdoc Add-on for arc42.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'ARCFOURTWO' && (fixVersion = '9.0.1' || fixVersion = '9.1.0.2') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


true
Section
hide
titleDoctypes for Java Developers

The following changes are part of the latest projectdoc for Java Developers.

This extension is experimental.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDJAVADEV' && (fixVersion = '5.01.0') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


true
Section
hide
titleDoctypes for Maven Developers

The following changes are part of the latest projectdoc for Maven Developers.

This extension is experimental.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDMVNDEV' && (fixVersion = '5.01.0') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd



...