Improvements heading to data center support. Requires rebuild of database table which may take up to hours to run.
Alpha Status
This version 5 of the projectdoc Toolbox is currently alpha.
We are rolling out this version on instances of selected customers.
It is currently not publicly available on the Atlassian Marketplace.
Today we released version 5.0 of the projectdoc Toolbox. It includes changes from version 5.0.0 to 5.0.2.
Since this is a major release, expect breaking changes!
Please read this release notes carefully prior to updating the projectdoc Toolbox!
This version 5 includes a couple of changes required for data center support. Data center support is planned to be supported by the major version of the projectdoc Toolbox.
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
Very quickly the most relevant changes in this release.
Editing Experience
A couple of improvements address the user experience when working with projectdoc documents in the Confluence page editor.
All these features are considered experimental and are currently in an early release status with some limitations (for details please follow the links below).
- Section Expander: Macros in the page editor can be collapsed or expanded
- Section NavigationThe editor can be opened at a specified location
- Dynamic Editor Content: Provides dynamic content generated by macros when in the page editor
Upgrade Instructions
Here is a 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.
Backup first, install add-on second!
This upgrade requires an upgrade of the projectdoc tables. This upgrade will be started automatically!
Expect this to be huge. Do not install this version of the projectdoc Toobox without a backup plan!
Upgrade Order
Please check again!
Make sure you have a recent backup and checked the upgrade in a test environment before you continue with the following steps.
projectdoc Toolbox with additional projectdoc add-ons
The projectdoc Toolbox will check that the versions of the add-ons are correct. If not, the upgrade process will be postponed. The issue will be logged at error level to the log and on each projectdoc document page online. This is the default process.
Alternatively you get full control over the process by setting the Java System system property de.smartics.projectdoc.upgrade.skip-auto to true. This will prevent the upgrade process to start. Install the projectdoc Toolbox then the extensions, unset the system property and restart the server.
For more information on updating information in the projectdoc database tables, please refer to Rebuild and Reindex, especially Upgrade Task.
Please install only those add-ons that are actually used! In case you do not use any of the projectdoc extensions, there is no need to install it. 
The migration process only starts when the projectdoc tables of version 5 are empty.
If these tables are not empty and the migration should be startet, please clear all tables of the projectdoc Toolbox with the PD5_ prefix.
It is highly recommended to not remove tables with the PD_ prefix until the migration process has completed successfully.
Automatic (recommended)- projectdoc Toolbox with extension and doctype add-ons:
- Update projectdoc Toolbox
- Check logs or open a projectdoc page to see if add-on updates are required
- update extension add-ons (start with Web API Extension)
- update doctype add-ons (start with Core Doctypes)
Manual - projectdoc Toolbox with extension and doctype add-ons:
- Set the system property when starting the JVM
-Dde.smartics.projectdoc.upgrade.skip-auto=true - Update projectdoc Toolbox
- Update extension add-ons (start with Web API Extension)
- Update doctype add-ons (start with Core Doctypes)
- Remove the system property added in step 1
-Dde.smartics.projectdoc.upgrade.skip-auto=true
