projectdoc Toolbox

Artificial Document Properties on Metadata, Tasks Report Macro, Section Compilations, Usability enhancements and more.

Today we released version 4.7 of the projectdoc Toolbox on the Atlassian Marketplace!

This release provides new features, improvements, and bugfixes.

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

Release Notes Overview

New and Noteworthy

Artificial Document Properties on Metadata

This release collects metadata to allow documentation gardners to find referencing documents easier.

Information on property names, controls, and values is collected as well as on document part identifiers and tags.

The following artificial properties support queries for documents that define a given name.

Name Short Description Since
Lists all used part identifier of a given projectdoc document.
4.7
Lists the parameter names of all macros on a projectdoc document.
4.7
Lists the names of all properties, excluding projectdoc metadata properties, of a projectdoc document.
4.7
Lists the values of all properties, excluding projectdoc metadata properties, of a projectdoc document.
4.7
Lists all used part identifier classes or tags of a given projectdoc document.
4.7

The following artificial properties support queries for documents that use a given name by reference.

Name Data Type Short Description Since
Lists identifiers used by macros of a projectdoc document to identify anchored content on other documents.
4.7
Lists all used CSS classes of a given projectdoc document that are mentioned as parameters of projectdoc macros.
4.7
Lists the names of all properties that are referenced by a given projectdoc document via display property macros.
4.7
4.10
Lists identifiers used by macros of a projectdoc document to identify content on other documents.
4.7
Lists the names of all macro parameters that are referenced by a given projectdoc document.
4.7
Lists macro parameter names used in the context of remote controls.
4.7
Lists the control names used by properties of a projectdoc document.
4.7
Lists the control values used by properties of a projectdoc document.
4.7
Lists the names of all properties that are referenced by a given projectdoc document.
4.7
Lists the names of all properties that are referenced by Select parameters in a projectdoc document.
4.7
Lists the names of all properties that are referenced by a given projectdoc document in Sort By parameters.
4.7
Lists tags used by macros of a projectdoc document to identify content on other documents.
4.7
Lists identifiers and tags used by macros of a projectdoc document to identify content on other documents.
4.7
Lists identifiers used by macros of a projectdoc document to identify transcluded content on other documents.
4.7
Lists tags used by macros of a projectdoc document to identify transcluded content on other documents.
4.7
Lists all values of remote controls that are not mapped to a property name by a macro parameter name.
4.7
Lists the names of all properties that are referenced by Where parameters in a projectdoc document.
4.7

More information on this topic is available at Name Refactorings.

A reindex is required to add the new properties (see Upgrade Instructions below).

Tasks Report Macro

The new Tasks Report Macro allows to select Confluence Tasks from projectdoc Documents selected by a Where constraint.

The new macro simply configures the Confluence Task Report Macro and executes it. The new macro is not a replacement. In case users want to select on spaces, pages, and labels, the original macro is still in charge. The new macro simply connects projectdoc documents to the world of Confluence Tasks.

Section Compilations

In software product documentation there is a good chance to encounter elements that are reused. For instance a parameter of a collection of macros. Suppose there is a collection of macros that transclude content from a single document. Each of these macros would provide a parameter named "Document" to link to the document to transclude from. Often the documentation for this parameter is identical. Therefore the documentation for the Document Parameter is in one location and the macros transclude this content.

The macros may need to control the order of their parameters. Maybe the first macro has the Document Parameter as its second parameter while all others specify it as their first.

In addition to that some macros may provide parameters they do not share with other macros. So authors may want to document these parameters in sections on the macro documentation document.

In this use case the Section Compiler by Reference Macro is of great support. The body of the macro holds the sections that document parameters the macro does not share. These sections may be in any order. The Section Compiler by Reference Macro references a property that defines the order of all parameters that are to be included in the macro document's documentation. Each reference may refer to a document that contains share information about a parameter or a section in the macros body.

This way it is very easy to mix and merge parameter documentation that is shared with information that has been defined locally.

Usability Enhancements

Autocomplete support is increased by supporting transclusion references ( PDAC-1315 - Getting issue details... STATUS ) and property names in drafts ( PDAC-1312 - Getting issue details... STATUS ).

The property name for the Display Document Property Macro is now a mandatory property ( PDAC-1314 - Getting issue details... STATUS ). Although the default would still be the name of the referenced document, by enforcing to specify a name the macro editor automatically pops up. Since the reference is often not to the name property, this update does better support the usability.

For Scroll Word Exporter (formerly known as Scroll Office) the projectdoc Toolbox now autodetects the required quirk mode ( PDAC-1324 - Getting issue details... STATUS ).

Upgrade Instructions

Here is a short guide to update to this new version of the projectdoc Toolbox. For detailed information on dependencies, please consult the documentation of the add-ons.

Installation Order

Please install the projectdoc Toolbox first, then the extensions and finally update the doctypes.

So this is the basic order:

  1. projectdoc Toolbox
  2. extension add-ons (start with Web API Extension)
  3.  doctype add-ons (start with Core Doctypes)

Please install only those add-ons that are actually used! In case you do not use the Web API, there is no need to install it. (smile)

Reindex

Due to the following issues a reindex is required to update properties.

Key Summary T P Description
Loading...
Refresh

In case you do not use any of these features, there is no need for a reindex.

Please refer to Troubleshooting Reindexer for projectdoc Documents for details on how to reindex projectdoc documents.

List of Changes

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

Key Summary T P Description
Loading...
Refresh

Related Releases

Extension Add-ons

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

Web API Extension

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

Key Summary T P Status Resolution Description
Loading...
Refresh

Maven Extension

The following changes are part of the latest Maven Extension.

Key Summary T P Status Resolution Description
Loading...
Refresh

Doctype 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.

Core Doctypes

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

Key Summary T P Status Resolution Description
Loading...
Refresh

Doctypes for Agile Planning

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

Key Summary T P Status Resolution Description
Loading...
Refresh

projectdoc Developer Diaries

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

Key Summary T P Status Resolution Description
Loading...
Refresh

Doctypes for Project Management

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

Key Summary T P Status Resolution Description
Loading...
Refresh

Doctypes for Service Management

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

Key Summary T P Status Resolution Description
Loading...
Refresh

Doctypes for Business Strategy

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

Key Summary T P Status Resolution Description
Loading...
Refresh

Doctypes for Software Development

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

Key Summary T P Status Resolution Description
Loading...
Refresh

Doctypes for Teamwork

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

Key Summary T P Status Resolution Description
Loading...
Refresh

Doctypes for V-Modell XT

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

Key Summary T P Status Resolution Description
Loading...
Refresh

projectdoc arc42 Template

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

Key Summary T P Status Resolution Description
Loading...
Refresh

Resources

Release Notes
Information on all released versions of the projectdoc Toolbox for Confluence.
Glossary
Terms used in and defined for projectdoc.
FAQs
Questions and answers related to the projectdoc Toolbox and Confluence.