projectdoc Toolbox 2.3.0 Release Notes

Template Support for Table Columns, Box Support for Transclusion, Space Console Construction for nameless Space Homepages, Doctype Homepage Property, and Scroll Office Boxes Support for Name List Macro

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

This release provides some new features and fixes some issues.

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

New and Noteworthy

The following changes may be the most interesting of this release.

Template Support for Table Columns

This new version allows to specify a template for rendering a column with the Display Table Macro. Now you can render more than one property in a table cell using a template (like the one used by the Display Document Properties Macro).

Use Templates to render complex values in a column cell. The syntax to specify a template is

#COLUMN_NAME{TEMPLATE_SPECIFICATION}

The column name is the label to use for the column heading. It may be replaced using Header Translations.

The template specification uses placeholders to reference properties.

Tool Support

This new feature is actually not directly relevant for users of the projectdoc Toolbox. It provides services to interface with the new tool model provided by the Doctypes Maven Plugin.

The new Core Doctypes provide a new version of the Documentation Dashboard takes advantage of this feature.

Box Support for Transclusion

projectdoc boxes are now first-class citizens in respect to transclusion.

Every box provides its name (e.g. 'pending-box' for the Pending Box Macro) as a default tag.

Using the new Documentation Dashboard allows now to track boxes more conveniently.

Doctype Homepage Property

There is a new artificial property called 'Doctype Homepage' that is a link to the document's doctype homepage.

This feature was supported by the Display Table Macro by automatically rewriting the values in the Doctype column. The new approach is much cleaner and is supported by all macros.

Note, since this is a new artificial property, to have it provided by existing documents, a reindex is required. Otherwise only new and updated documents will provide this property.

Upgrade Instructions

Install the new OBR of the projectdoc Toolbox.

To support the new artificial property Doctype Homepage, run a reindex. If you do not use this new property, a reindex is not required.

Updating the following doctype add-ons is recommended.

Add-on for the projectdoc Toolbox Version
11.0.0
6.0.2
3.0.1

List of Changes

The complete list of changes for this release.

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

Key Summary T P Status Resolution Description
PDAC-878 Template Support for Table Columns New Feature Critical (migrated) Done Fixed

The Display Table Macro should support templates for columns.

Use #COLUMN_NAME{TEMPLATE} as syntax to specify a template (with references to properties) for a column. The COLUMN_NAME should be used as the column heading. The template is applied to each cell in the column.

PDAC-879 Box Support for Transclusion New Feature Major Done Fixed

Box macros need to be able to be transcluded.

PDAC-877 Tool Support New Feature Major Done Fixed

Support tools for Model Projects.

PDAC-875 Scroll Office Boxes Support for Name List Macro Improvement Major Done Fixed

The Name List Macro allows to render Boxes styled by CSS. Unfortunately the boxes do not render with Scroll Office since the structure we render does not match that of the status macro.

We need to follow the structure of the status macro to be rendered in the generated Word document.

PDAC-874 Support Calender in every Content Provider Improvement Major Done Fixed

Currently only one Content Provider add date information. Since some blueprints require date and some other feature we need to provide the date service to all Content Providers.

PDAC-872 Doctype Homepage Property Improvement Major Done Fixed

Provide an artificial property called 'Doctype Homepage' that renders a link to the doctype's homepage.

This is currently what the Display Table does for the 'Doctype' property automatically (but maybe should not in future). Provding a new artificial property allows this feature to use in all context where properties of documents are accessed.

Note that this feature requires a reindex since the new artificial property needs to be created.

PDAC-871 Space Console Construction for nameless Space Homepages Bug Major Done Fixed

Creating a default Name Property from the Title Property for the Nameless Document Feature fails if the space homepage (or related pages) do themselves not provide a Name property.

Since we do not want to force users to provide a Name property, this needs to be fixed.

PDAC-876 Heading Styles Fix for Display Table Bug Minor (migrated) Done Fixed

Styles fail to be applied to the correct header column in case the counter column is activated.

PDAC-873 hide-metadata-for-printing fails for Word Bug Minor (migrated) Done Fixed

Using the space hide-metadata-for-printing works for PDF export, but not for Word. Word supposedly does not support CSS. 

Related Releases

Doctype Add-ons

Doctype add-ons provide space and page blueprints based on the projectdoc Toolbox.

Doctype add-ons typically provide blueprints based on macros provided by the projectdoc Toolbox. These add-ons need a licensed version of the projectdoc Toolbox to be installed.

projectdoc Core Doctypes

List of changes in this add-on.

Key Summary T P Status Resolution Description
PDCORED-152 Documentation Dashboard New Feature Critical (migrated) Done Fixed

Provide a tool where author boxes are being tracked.

Instead of the first version, the boxes should be listed on different pages.

PDCORED-155 Docsection Support for Homepages and Index Pages New Feature Major Done Fixed

To make it easier to provide additional views on documents, the section on homepages and index pages should display additional docsections (as children to the homepage) automatically.

PDCORED-153 Add Documentation Section to Role Improvement Major Done Fixed

Since Audience is part of every document, listing the documents with the role seems quite natural.

PDCORED-156 Translation missing for Duration Bug Minor (migrated) Done Fixed

The translation for the property duration is missing for locale DE for the resource doctype.

PDCORED-154 Stimulus Selection for Role Doctype Bug Minor (migrated) Done Fixed

The role doctype fails to translate the stimulus localization key.

PDCORED-151 Typo in Subordinate Excerpts Heading (DE) Bug Minor (migrated) Done Fixed

The Heading "excerpt.xmle" must read "Exzerpte".

projectdoc Developer Diaries

List of changes in this add-on.

Key Summary T P Status Resolution Description
DEVDIARY-66 Restrict Mood Search on Year Doctype Bug Minor (migrated) Done Fixed

The year template needs to restrict the search for the mood graph to its children.

Extension Add-ons

Extension add-ons extends the functionality of the projectdoc Toolbox.

Extension add-ons for the projectdoc Toolbox provide additional features. Extensions need a licensed version of the projectdoc Toolbox to be installed.

Web API Extension

List of changes in this add-on.

Key Summary T P Status Resolution Description
PDEXWAPI-22 Properties Input Problem Bug Critical (migrated) Done Fixed

Posting a properties file fails with

java.lang.IllegalArgumentException: argument type mismatch

PDEXWAPI-21 HTML Rendering fails Bug Critical (migrated) Done Fixed

Choosing HTML as rendering option for sections fails to render the Confluence storage format input properly.

Resources

Release Notes for the projectdoc Toolbox
Relevant information on changes to the projectdoc Toolbox for Confluence introduces by new versions of this app.
Glossary
Terms used in and defined for projectdoc.
FAQs
Questions and answers related to the projectdoc Toolbox and Confluence.