- Created by Robert Reiner, last modified on 25. Jul 2018
projectdoc Toolbox
New macros, improvements, and bugfixes. Requires update of extensions and all doctype add-ons
Today we released version 1.17.0 of the projectdoc Toolbox on the Atlassian Marketplace!
The projectdoc Toolbox is an add-on for Confluence supporting agile software development teams to collaborate on process, project, system, and product documentation.
If you want to learn more about the projectdoc Toolbox and how it helps to create good project documentation, please refer to the introduction video!
The following image is a link to a video on YouTube. When you click the link your browser will serve a page from youtube.com.
Very interesting, but way too fast?
Step through at your own pace with with our Prezi Presentation (external link to prezi.com)!
In the Online Manual you’ll find additional video material that introduces you in the concepts of the projectdoc Toolbox.
Refer to use cases and show cases for information on how to use the projectdoc Toolbox.
New and Noteworthy
The following changes may be the most interesting of this release.
Tour Macro Supports Templates
The Tour Macro accepts templates containing property references in columns that do not references the document. That is ${} and $[] (for linked property values) may be used in table cells to define the rendered content. This feature makes it very easy to define columns where text with multiple properties are rendered.
See PDAC-775 - Getting issue details... STATUS .
Display List Template Macro
The Display List Template Macro allows templates to specify the content of the list items. Use ${} and $[] (for linked property values) to reference propery values with the Name Template and the Data Template.
See PDAC-748 - Getting issue details... STATUS .
Transclusion to Text Macro
The new Transclusion to Text Macro allows to transclude content from a Confluence page as plain text.
This macro is usful in use cases where the transcluded content is further processed by an enclosing macro (like the Body Graph Macro).
Breaking Changes
Doctype Add-ons and Bookmarklet Extension
Due to an internal API change all doctype add-ons and the Bookmarklets Extension need to be updated.
See PDAC-758 - Getting issue details... STATUS .
Tour Macro
In case a cell of the table inside the Tour Macro contains text value, this test is rendered instead of the property whose value is referenced by the column title.
See PDAC-774 - Getting issue details... STATUS .
Renamed Artificial Property for Locale DE
The German translation for Space Title is now "Bereichstitel" instead of "Bereich" due to PDAC-771 - Getting issue details... STATUS .
Transclusions defined by ID
In previous versions the transclusion defined the part of transcluded content by the title of a Section. With this version the ID (if present) is used. When referencing the ID of a section, changes to the title would not take effect on the transclusion defined in other pages (since the ID stays the same).
See PDAC-751 - Getting issue details... STATUS .
Upgrade Instructions
The following topics have to be considered for an upgrade to this version.
Install the new OBR of the projectdoc Toolbox first.
Required Add-on Updates
The following add-ons need to be updated to work with this version of the projectdoc Toolbox.
| Add-on for the projectdoc Toolbox | Required Version |
|---|---|
7.0.0 or newer | |
7.0.0 or newer | |
5.0.0 or newer | |
6.0.0 or newer | |
5.0.0 or newer | |
3.0.0 or newer | |
3.0.0 or newer | |
2.0.0 or newer | |
2.0.0 or newer | |
1.3.1 or newer |
Reindex recommended
Due to a new artificial property, called Space Link, a reindex is recommended.
If not, existing pages do not have this additional property.
See PDAC-771 - Getting issue details... STATUS
List of Changes
The complete list of changes for this release.
Related Releases
Doctype Add-ons
Doctype add-ons provide space and page blueprints based on the projectdoc Toolbox.
projectdoc for Software Development
Extension Add-ons
Extension add-ons extends the functionality of the projectdoc Toolbox.
Resources
- Release Notes Archive
- FAQs
