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.

The query matched no documents.

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

The query matched no documents.

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

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. 

Reindex

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

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.

Extension Add-ons

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

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.