projectdoc Toolbox 1.11 Release Notes

Section

Column

Document Properties Marker

override	false

Short Description

Property Supplier Macro, Placeholders in Space Properties, Transclusion from Confluence Pages, Extension Support, and Heading Level for Sections

Doctype

release-note

hide

Name

projectdoc Toolbox 1.11 Release Notes

Parent

Parent Property

property-name	Name

Audience

Name List

doctype	role
property	Audience

Subject

Name List

doctype	subject
property	Subject

Tags

Tag List

property	Tags

Iteration

value	filled

hide

Version

1.11

hide

Product

projectdoc Toolbox

hide

Release Date

05 May 2016

hide

JIRA Release Notes

https://www.smartics.eu/jira/projects/PDAC/versions/11400

hide

Sort Key

00001.00011

hide

enable-heading-numbers

true

hide

Section

show-title	false
title	Description

Today we released version

Display Property

property-name	Version

of the projectdoc Toolbox on the Atlassian Marketplace!

Panel

borderColor	darkgrey
borderWidth	2

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

Transclusion

document	HOMESPACE:projectdoc Video Link
ids	projectdoc

Info Box
Download projectdoc or visit projectdoc site on Atlassian Marketplace!

Column

width	400px

Panel

title	Contents

Table of Contents

outline	true
indent	15px
exclude	Release Notes\|Description\|Summary\|References\|Resources
style	none

...

Section

title	New and Noteworthy
intro-text	The following changes may be the most interesting of this release.

Section

title	Property Supplier Macro

With this version it is now very easy to specify document properties in separate tables. This makes it possible to group properties semantically and show them on different locations of the page.

There is still one Document Properties Marker Macro required, but there can be any number of additional Document Properties Supplier Macros. The author is still responsible to make sure that each property is provided only once.

Document Properties as Data provides a tip on using the Document Properties Supplier Macro.

Section

title	Placeholders in Space Properties

It is now very easy to references space properties within a space property value. Just use ${name} where name refers to another space property.

A typical usage scenario is to define the version of a product and reuse this information within other space properties.

Code Block

url-scm=https://bitbucket.org/smartics
project.artifactId=smartics-projectdoc-confluence-space-core
project.version=5.1.0
url-download-sources=${url-scm}/${project.artifactId}/get/${project.artifactId}-${project.version}.zip

Using Space Properties provides tips on working with space properties.

Section

title	Extension Support

We have learned that users of the projectdoc Toolbox are overwhelmed its the features. While being feature rich is a good thing, overwhelming is not. Therefore we decided to move some of the core features to extensions. This way users can better decide which features they want to install and which not.

With this release the support for information systems integration and for Maven moved to extensions.

Tour

render-as-definition-list	true
replace-title-with-name	true

Title	Short Description
Information Systems Extension
Maven Extension

Caution Box

If you relay on the information systems' macros or the Maven support, please make sure to upgrade to

Display Property

property-name	Version

of the projectdoc Toolbox once these extensions are publicly available!

Both extensions are free to use and installed as additional add-ons to the required projectdoc Toolbox.

Section

title	Information Systems Extension

Due to the introduction of placeholders in space properties, referring to resources on remote information systems is now much easier. Macros that solely provided means to construct URLs out of several parts are now deprecated and will be removed with one of the next releases.

The most important feature of this release is the support for autoconversion. Every URL that is defined as an external resource will be automatically converted to a macro. This makes it very easy to replace the base URL to an information system in case the system moved to another location.

For more information on working with remote information systems, please refer to Information Systems Extension.

Section

title	Maven Extension

The Maven Extension provides tools to create spaces and pages based on artifact information. Currently information is read from POMs, buildmetadata, and Maven Plugin Descriptors.

Section

title	Transclusion from Confluence Pages

Prior version of the projectdoc Toolbox required the transcluding and the transcluded page to be projectdoc documents. With version

Display Property

property-name	Version

both ends of the transclusion may now be Confluence pages. That is: neither page needs to have the Document Properties Marker Macro.

Section

title	Heading Level for Sections

With this version of the projectdoc Toolbox the starting level of sections can be configured per space. That is: the team may decide whether the titles of the top-level sections are rendered as h1 or h2.

The rendering is controlled by the space property heading-starting-level Heading Starting Level.

Section

title	Control on Name Selection

The Name List Macro now allows the template author to restrict the selection of names. By configuration of the macro the user is aware to choose only one value or values from a given range.

Jira
server smartics JIRA
serverId 79ad43bc-d289-364e-bfc7-46c09847bebd
key PDAC-630
Jira
server smartics JIRA
serverId 79ad43bc-d289-364e-bfc7-46c09847bebd
key PDAC-631

...

Space shortcuts

Page tree

Docs

Support

Free Blueprints

Tooling for Blueprints

Free Extensions

Spaces

Plugins for Maven

Incubator

Libraries for Java

Incubator

Add-ons for Confluence

Tools

Support

Team

Legal

Versions Compared

Old Version 3

New Version Current

Key

About

Keep up-to-date!

Powered by