projectdoc Toolbox 4.12 Release Notes

Support for Confluence 7.12 and Identify Text Passages for technical Texts.

Today we released version 4.12 of the projectdoc Toolbox.

This is a bugfix feature release.

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

Identify Text Passages

For technical documents, such as specifications, it is useful to make text elements inside a section identifiable.

This version allows to render an identifier with the Content Marker Macro by PDAC-1442 - Merge Paragraphs Done , PDAC-1443 - Content Marker Count Done , and PDAC-1449 - Debug Mode for Index Entries Table Done .

The above example shows definitions (Def...) and explanations (Expl...) numbered. The content is explicitly marked with the Content Marker Macro and tagged to be identified as definition or explanation. The numbers are added per position of the content.

For more information please refer to the tips Identify Document Elements and Merge Content.

Debug Mode

Some macros will provide a special debug mode that will render issues inside the page. One use case is to render terms of the glossary in a glossary section. If a term is not already defined, the missing term will be rendered in a box if debug mode is enabled.

For more information please refer to Debug Mode. For this version of the projectdoc Toolbox only the Index Entries Table Macro support this feature.

Installation Instructions

Install the new OBR of the projectdoc Toolbox.

Upgrade Instructions

Please follow this 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.

So this is the basic order:

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

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)

List of Changes

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

Key Summary T P Description
PDAC-1454 Support Confluence 7.12 Improvement Critical (migrated)

Confluence 7.12 seems to no longer support the confluence-extractor-api-plugin.

Also there is an issue with filesystem.filestore components.

PDAC-1448 Debug Mode New Feature Major

Support a space property named 'projectdoc.debug-mode' to control whether or not encountered issues should be presented in the rendered content.

PDAC-1443 Content Marker Count New Feature Major

Provide a parameter that allows to render a counter for the Content Marker Macro.

This allows to autonumber content elements on a page.

PDAC-1442 Merge Paragraphs New Feature Major

A parameter of the Content Marker Macro allows to merge multiple paragraph elements.

PDAC-1444 Content Marker Wrapper Element Fix Bug Major

The Wrapper Element parameter does not work if identifier is set for users with edit privileges.

The specified element name must be checked to be a valid html tag.

PDAC-1449 Debug Mode for Index Entries Table New Feature Minor (migrated)

Use the space property 'projectdoc.debug-mode' to render issues with undefined terms.

PDAC-1455 Fix Table Merger with named Columns Bug Minor (migrated)

If the column names to create a merged table are specified and the column name translation is used, the tables render incorrectly. Instead of merging the columns with different names, all columns are added despite the specified column names.

PDAC-1453 Performance Issue on Page Move Bug Minor (migrated)

On a page move the Move event is processed two times: On start and on end.

PDAC-1452 Performance Issue on Page Update Bug Minor (migrated)

When updating a page the artificial properties are calculated more than once with the same load strategy.

PDAC-1451 Page Preview for Table Merger Macro Bug Minor (migrated)

The Table Merger Macro should support page preview, but fails.

PDAC-1447 Unknown Space Tag Handling in Queries Bug Minor (migrated)

In the context of querying documents: If an unknown space category is specifed in a query (for instance with the Display Table Macro) and there is no other space in the query specified, then the result must be empty.

PDAC-1446 Cache Update on Attachment Delete Bug Minor (migrated)

When a referenced attachment is deleted, the document is not removed from the cache. Then the link is still rendered as existing, but should be rendered as non existing.

PDAC-1445 Typo in Intro Text of Ressources (DE) Bug Minor (migrated)

The introductional text of the Resource section contrains a typo for the Locale DE.

Related Releases

Extension Add-ons

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

Doctype Add-on Version
9.1.1
3.3.0

Web API Extension

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

Key Summary T P Status Resolution Description
PDEXWAPI-60 Ready for Read-Only Mode New Feature Major Done Fixed

As part of data center support the read-only mode must be considered by the event processing and REST services.

This makes the extension ready to support read-only mode.
 

PDEXWAPI-57 Reference Space New Feature Major Done Fixed

Support the reference space space property provided by the projectdoc Toolbox 4.10.

PDEXWAPI-59 Documents Search fails to Sort Bug Major Done Fixed

The query parameter sort-by does not work.

Information Systems Extension

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

Key Summary T P Status Resolution Description
PDEXINFOSY-43 Identifier Link Macro New Feature Major Done Fixed

Add a macro to render pseudo-URLs.

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.