This year we attend the OOP in Munich again!

We are looking forward to the OOP 2019 with a large list of very interesting sessions and keynotes.

It starts tomorrow (21st of January 2019) and we will be there from Tuesday to Thursday. We hope to meet a lot of friends and IT enthusiasts there!

Today we released version 2.5.1 of the projectdoc Toolbox for Confluence!

projectdoc supports agile teams creating and maintaining project documentation. It provides templates and tools to improve the collaboration of team members.

This release provides new features, improvements for existing features and bugfixes.

For more information, please refer to the projectdoc Toolbox 2.5 Release Notes.

Release Notes - projectdoc Toolbox - Version 2.5.0

Bug

• [PDAC-900] - Rephrase Hint for Short Description (de) in Space Blueprint Wizard
• [PDAC-901] - Replace Doctype by Dokumenttyp for Locale DE
• [PDAC-903] - URL handling by Display Property Macros
• [PDAC-905] - Current Date (@currentDate) not replaced
• [PDAC-907] - Quote Macro and blank Authors
• [PDAC-909] - Definition List Template for Display Table Macro
• [PDAC-910] - Fails Replacing Title with Name
• [PDAC-917] - Blank Space Key Message
• [PDAC-921] - Missing Label doctype-homepage
• [PDAC-922] - Phantom References broken
• [PDAC-925] - Delegate Document Reference
• [PDAC-930] - Search Space fails with @all
• [PDAC-934] - Add missing Key for Homepage Index Description
• [PDAC-936] - Template and Curly Brackets
• [PDAC-939] - Don't render Append Text if Property Value is blank
• [PDAC-940] - Don't render Append Text if Parent Property Value is blank
• [PDAC-941] - I18N for JavaScript Messages
• [PDAC-943] - Column Styles for Table Merger
• [PDAC-944] - Tag List Macro renders non-global Labels
• [PDAC-956] - Missing Translation for Macro Descriptions
• [PDAC-961] - Show Empty Rows not honored with Vertical Tabs
• [PDAC-963] - Short Names Link Generation for Index fails
• [PDAC-970] - Description of Parameters for Blueprint REST Service
• [PDAC-972] - Runtime Exception on Table Merger without Styles
• [PDAC-973] - Phantom References for Create One Document Macro
• [PDAC-975] - Blueprints REST API fails on null Page ID

New Feature

• [PDAC-825] - Support Lists for Deep Links
• [PDAC-902] - Allow multiple Doctypes for Parent Macro
• [PDAC-911] - Provide File and File Folder as Domain Terms
• [PDAC-914] - Check Property Value for Sections
• [PDAC-915] - Flags Property
• [PDAC-916] - Wiki Syntax for selected Macros
• [PDAC-920] - Render Expand Macros without Content as blank
• [PDAC-929] - Ancestor Searches in Lists
• [PDAC-932] - Parent Doctype Related Subdocuments
• [PDAC-933] - Support Merging and Deleting from List Parameters
• [PDAC-937] - Discard Items with Table Merger
• [PDAC-938] - Support Grouping Doctypes with Properties
• [PDAC-945] - Page Include Macro
• [PDAC-946] - Display Property from Primary Page
• [PDAC-950] - Random Transclusion Macro
• [PDAC-951] - Action Button Macro
• [PDAC-952] - Layout Element Macro
• [PDAC-953] - Image Element Macro
• [PDAC-958] - Header Translations for all Macros with Select Param
• [PDAC-959] - Support Space Imports
• [PDAC-964] - List Match with AND
• [PDAC-966] - Sort Elements in Table Merger Macro
• [PDAC-968] - Doctype Metadata from Model
• [PDAC-969] - Internal Doctype REST Service

Improvement

• [PDAC-899] - Support Replacements for rendered Placeholders
• [PDAC-904] - Reject Title Replacements for Restricted Parent Pages and Spaces
• [PDAC-906] - Check Space and Parent Page Access Rights for Blueprint Metadata
• [PDAC-908] - Render Publisher in Quote Macro
• [PDAC-912] - Support for Related Indices
• [PDAC-913] - Replace @currentMonth as Placeholder in Titles
• [PDAC-918] - Empty Tour Table
• [PDAC-919] - Find Image Text Representation in Title
• [PDAC-923] - Skip Rendering empty DT or DD for Tour Macro
• [PDAC-924] - Default Handling of ProjectdocMacroContext
• [PDAC-926] - Compact representation for Hide Macros
• [PDAC-927] - Hide extracted Short Description
• [PDAC-928] - Exact Match on Empty Property
• [PDAC-931] - Update Get-Started Page
• [PDAC-935] - Allow to filter on Space Status
• [PDAC-942] - Provide standard Property for Participants
• [PDAC-947] - Add Primary Page Option to Breadcrumbs
• [PDAC-948] - Support Wiki Syntax with Breadcrumb Macro
• [PDAC-949] - NPE on Displaying on a Missing Page
• [PDAC-954] - Quote Macro Support for Quote Doctype
• [PDAC-955] - Support PDF Mode for Heading
• [PDAC-957] - Prevent Query Execution without Constraints
• [PDAC-960] - Reject All Feature for Transclusion
• [PDAC-962] - CSS Selectors for Permissions
• [PDAC-965] - Remove Duplicate Lines from Table Merger
• [PDAC-967] - Default for Loading Doctype Metadata
• [PDAC-974] - Create One Document Macro Subpage Title
• [PDAC-976] - Support to Control Column Number Header
• [PDAC-977] - Apply Sort Key to List Children
• [PDAC-978] - Select on Doctype

Release Notes - projectdoc Toolbox - Version 2.5.1

Bug

• [PDAC-981] - Reference Tracking for Display Property Ref Macros
• [PDAC-984] - Ancestor Property Fix

Improvement

• [PDAC-982] - Classification Property
• [PDAC-983] - Improve Move Events
• [PDAC-985] - Object Property
• [PDAC-986] - Performance Problem on Move Page Tree

Today we released version 1.1.0 of the Doctype Maven Plugin to create doctypes for the projectdoc Toolbox!

The plugin for Maven allows to generate add-ons for Confluence with page blueprints and space blueprints based on the projectdoc Toolbox.

projectdoc supports agile teams creating and maintaining project documentation. It provides templates and tools to improve the collaboration of team members.

Release Notes - Doctypes Maven Plugin - Version 1.1.0

Bug

• [DTSMP-1] - Delegate Document Reference
• [DTSMP-12] - Description does not get overridden
• [DTSMP-15] - Support Leading Spaces in Property Values

New Feature

• [DTSMP-2] - Support Wizard Parameters
• [DTSMP-3] - Support Wizard Fields
• [DTSMP-4] - Support for Web Resources
• [DTSMP-5] - Generate in-context Property by Default
• [DTSMP-6] - Create Docmap JSON File
• [DTSMP-7] - Concat Docmaps Mojo
• [DTSMP-8] - Simple Support for RDF for Doctypes
• [DTSMP-9] - Support Merging Sections
• [DTSMP-11] - Command Line Default Configuration
• [DTSMP-13] - Support Doctype Metadata
• [DTSMP-14] - Move Metadata to projectdoc Folder

Improvement

• [DTSMP-10] - Add Column Marker to Resources and References

Profiling a Confluence server, which has been locally started via the Atlassian SDK, should be straight forward. Start the server, attach the Java VisualVM and you are done. Unfortunately, when trying to instrument the classes deployed to the server for CPU profiling, the following exception is thrown on the console:

Caused by: java.lang.NoClassDefFoundError: 
  org/netbeans/lib/profiler/server/ProfilerRuntimeCPUFullInstr

What seems to tell that a required class is not provided is actually a complaint that the OSGi subsystem has not been configured properly.

Add the following lines to specify a profile with additional system properties to your Maven POM to configure Confluence:

<profile>
  <id>profiling</id>
    <build>
      <pluginManagement>
        <plugins>
          <plugin>
            <groupId>com.atlassian.maven.plugins</groupId>
            <artifactId>maven-confluence-plugin</artifactId>
            <version>6.3.21</version>
            <extensions>true</extensions>
            <configuration>
              <systemPropertyVariables>
                <atlassian.org.osgi.framework.bootdelegation>
                  org.netbeans.lib.profiler.*,sun.*,com.sun.*
                </atlassian.org.osgi.framework.bootdelegation>
                <atlassian.org.osgi.framework.system.packages>
                  org.netbeans.lib.profiler.server
                </atlassian.org.osgi.framework.system.packages>
            </systemPropertyVariables>
          </configuration>
        </plugin>
      </plugins>
    </pluginManagement>
  </build>
</profile>

Start the Confluence server locally using the Atlassian SDK:

atlas-debug -Pprofiling

Then add a configuration via the Java VisualVM's UI to limit instrumentation to classes you want to take execution performance measurements:

Finally start the instrumentation!

Finding the system property names took me some time, so hopefully this blog article shortens the time of searching for others.