Blog

We released the Apptools Maven Plugin in version 0.11.1!

This plugin for Maven is used to interface with the Universal Plugin Manager's (UPM) REST API to deploy apps (formerly known as add-ons or plugins) to a remote Confluence server. It is a tool for developers to deploy a number of JARs/OBRs to an environment, like development, test, pre-production. The plugin may operate on a single project, handling the artifact of this project, or may be based on a POM project that defines a set of apps to be deployed to different environments.

This new version provides two bugfixes.

For more information please  visit the tool's website!

Release Notes - Apptools Maven Plugin - Version 0.11.1

Bug

  • [APPMP-24] - Release Version compared to Snapshot Version fails
  • [APPMP-25] - Problems with Retry on Deployments

projectdoc Toolbox 2.7

Today we released version 2.7.0 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.

Updating of the free doctype add-ons and extension add-ons is recommended.

For more information, please refer to the release notes.

Release Notes - projectdoc Toolbox - Version 2.7.0

Bug

  • [PDAC-999] - Allow HTML Elements in Tour Macro
  • [PDAC-1000] - Replacement fails on partial Placeholder Supply
  • [PDAC-1004] - Fix Rendering Issue with HTML IDs
  • [PDAC-1005] - Normalize HTML IDs used in Transclusion
  • [PDAC-1007] - Provide XhtmlContentHandler as Service

New Feature

  • [PDAC-663] - Document Impersonator
  • [PDAC-1006] - Support Services for Document Creation and Placeholder Handling

Improvement

  • [PDAC-1001] - Add Flags Property to Blank Doctype
  • [PDAC-1002] - Render Problems with the Query in an Error Box
  • [PDAC-1003] - Query Parameters as HTML Data Attributes

Today we released version 1.4 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.


We released the Apptools Maven Plugin in version 0.11.0!

This plugin for Maven is used  to interface with the Universal Plugin Manager's (UPM) REST API to deploy apps (formerly know and add-ons or plugins) to a remote Confluence server. It is a tool for developers to deploy a number of JARs/OBRs to an environment, like development, test, pre-production. The plugin may operate on a single project, handling the artifact of this project, or may be based on a POM project that defines a set of apps to be deployed to different environments.

This new version checks the timestamp for snapshot versions alos with the check-deployment goal.

There is also a new article Unique Snapshot Versions for an introduction on how to configure your project for this new feature.

For more information please visit the tool's website!

 

To use the new Timestamped Version feature for snapshot versions, consider to use the buildmetadata-maven-plugin with version 1.7.0.

Release Notes - Apptools Maven Plugin - Version 0.11.0

Bug

  • [APPMP-23] - Failing to render a failed Check

New Feature

  • [APPMP-22] - Unique Snapshot Versions Support for Check Deployment

Improvement

  • [APPMP-21] - Use Timestamp from atlassian-plugin.xml

Tip: Web of Documents

Today we added a new tip on

Web of Documents

for the projectdoc Toolbox.

The short tip shows how doctypes based on the projectdoc Toolbox for Confluence support navigability by an example based on the doctypes organization, person, role, and stakeholder.

What is projectdoc?

The projectdoc Toolbox is a collection of a large number of tools to help teams to create modular, agile documentation collaboratively and with fun. The toolbox is an add-on for Confluence and is available on the Atlassian Marketplace.

The tools in the projectdoc Toolbox consist basically of macros, doctypes, and a handful of conventions. The number of these tools is overwhelming, especially for new users.

One Tip at a Time

Learning a new tool is not easy because users need to get their tasks done. Learning a new tool takes time, time that is not available.

Learning by tips - one tip at a time

Users learn some interesting aspects of projectdoc by reading one tip at a time. The tips show aspects of projectdoc and link to resources to learn more about a specific top - just in case.



Feedback welcome!

If you have questions or comments, please get in touch!



We released the Apptools Maven Plugin in version 0.10.0!

This plugin for Maven is used to interface with the Universal Plugin Manager's (UPM) REST API to deploy apps (formerly known as add-ons or plugins) to a remote Confluence server. It is a tool for developers to deploy a number of JARs/OBRs to an environment, like development, test, pre-production. The plugin may operate on a single project, handling the artifact of this project, or may be based on a POM project that defines a set of apps to be deployed to different environments.

For more information please visit the tool's website !

 

To use the new Timestamped Version feature for snapshot versions, consider to use the buildmetadata-maven-plugin with version 1.7.0.

Release Notes - Apptools Maven Plugin - Version 0.10.0

Bug

  • [APPMP-8] - Fix 500 on larger Deployments
  • [APPMP-14] - Typo in Name of User Parameter 'apptools.checkWait'
  • [APPMP-15] - Remove dryRun Option from check-configuration
  • [APPMP-19] - Overriding with global Parameters on the Command Line fails
  • [APPMP-20] - Token is fetched in dryRun Mode

New Feature

  • [APPMP-11] - Support for Timestamped Versions

Improvement

  • [APPMP-9] - Check if App is already deployed
  • [APPMP-10] - Warn if no App is selected
  • [APPMP-16] - Clarify Description of check-configuration
  • [APPMP-17] - Render the active Environment Profile in Check Reports
  • [APPMP-18] - Remove dryRun mode from Check Deployment

Today we added a new tip on

Impersonator - using Live Templates

for the projectdoc Toolbox.

The short tip shows how to employ a special version of transclusion with the projectdoc Toolbox for Confluence.

What is projectdoc?

The projectdoc Toolbox is a collection of a large number of tools to help teams to create modular, agile documentation collaboratively and with fun. The toolbox is an add-on for Confluence and is available on the Atlassian Marketplace.

The tools in the projectdoc Toolbox consist basically of macros, doctypes, and a handful of conventions. The number of these tools is overwhelming, especially for new users.

One Tip at a Time

Learning a new tool is not easy because users need to get their tasks done. Learning a new tool takes time, time that is not available.

Learning by tips - one tip at a time

Users learn some interesting aspects of projectdoc by reading one tip at a time. The tips show aspects of projectdoc and link to resources to learn more about a specific top - just in case.



Feedback welcome!

If you have questions or comments, please get in touch!



Today we published a bugfix release for the smartics JIRA Maven Plugin in version 0.2.3.

The smartics JIRA Maven Plugin supports updating information on a JIRA server to integrate into our Maven build process.

This plugin is one additional building block for the automation of process around the projectdoc Toolbox for Confluence. Together with the Doctype Maven Plugin and the Apptools Maven Plugin this is the third plugin to make daily tasks simple and fast to execute.

Release Notes

Bug

  • [SJMP-10] - Add missing Support for Priorities
  • [SJMP-11] - Selecting Version must skip archived Versions

Improvement

  • [SJMP-9] - Normalize Issue Elements

Resources

More information about the smartics JIRA Maven Plugin.

smartics JIRA Maven Plugin 0.2.2
Blog article with notes for the previous release of the plugin.

Today we released the Buildmetadata Maven Plugin to Maven Repo 1!

The Buildmetadata Maven Plugin provides properties to the build process. These properties can be used as metadata to be stored with the generated artifacts or can control the build process.

This release contains some small features to access the version number parts as build properties. It also allows to format the timestamp information by a custom pattern.

We use this new information to construct unique version IDs for our Confluence add-ons when we deploy snapshot versions to our different environments.

Release Notes - Buildmetadata Maven Plugin - Version 1.7.0

Bug

  • [BMMP-107] - Fix Missing System Property Name

New Feature

  • [BMMP-104] - Add Version Number Properties
  • [BMMP-105] - Add Timestamp Options
  • [BMMP-106] - Include Hours, Minutes, and Seconds in the Full Version

We are very happy to announce that the free add-ons Doctypes for Service Management (ITSM) and Doctypes for Business Strategy are now available on the Atlassian Marketplace!

Both add-ons provide page blueprints and space blueprints that use tools (especially macros) from the commercial projectdoc Toolbox for Confluence. The projectdoc Toolbox is also available on the Atlassian Marketplace – together with a number of projectdoc Extensions and other Doctype Add-ons that provide additional tools for collaborative, technical documentation with Confluence.

IT Service Management

The Doctypes for Service Management support teams to document their servicessystemsconfiguration items and many more. This is a top-down approach where the service strategy is developed in advance of establishing the systems. The free extensions for the projectdoc Toolbox including the Web API Extension and the Information Systems Extension support teams to integrate information from outside the Confluence platform into projectdoc Documents. A projectdoc document is a traditional Confluence page with document properties and document sections.

Space for IT Service Management (ITSM)

Business Strategy

The Doctypes for Business Strategy includes doctypes to define the missionvision, and strategy for a team. There is also a blueprint to make SWOT analyses. It is designed to provided some basic structure to define the reason and goals of an organization or product. It helps teams to develop a common understanding and is therefore a tool to use right at the start.

Space for Business Strategy

Available on the Atlassian Marketplace

The two add-ons for Confluence are available for download on the Atlassian Marketplace:

Both can be installed very easily via the Confluence add-on manager. Please make sure you have the projectdoc Toolbox for Confluence (commercial) and the Core Doctypes (free) installed! Both are required for the free doctype add-ons to work.

Find more apps by smartics for Confluence on the Atlassian Marketplace!





Today we published a bugfix release for the smartics JIRA Maven Plugin in version 0.2.2.

The smartics JIRA Maven Plugin supports updating information on a JIRA server to integrate into our Maven build process.

This plugin is one additional building block for the automation of process around the projectdoc Toolbox for Confluence. Together with the Doctype Maven Plugin and the Apptools Maven Plugin this is the third plugin to make daily tasks simple and fast to execute.

Release Notes

Bug

  • [SJMP-7] - Versions created in wrong order

Improvement

  • [SJMP-5] - Use Issue Management System as Default for systemId
  • [SJMP-6] - Log currently processed Issue Key
  • [SJMP-8] - Log checked Version Number

Resources

More information about the smartics JIRA Maven Plugin.

smartics JIRA Maven Plugin 0.2.1
Blog article with notes for the previous release of the plugin.

Anton talked about our new Apptools Maven Plugin at the Atlassian User Group Munich today! Lightning fast he introduces the basic concepts to deploy apps to different environments from the context of a Maven project.

The Lightning Talk for Apptools Maven Plugin – what he showed at the meeting on 14th March 2019 – is on our website!

Thank you to everyone on the meetup, especially for your warm feedback!


We released the Apptools Maven Plugin in version 0.9.0!

This plugin for Maven is used to interface with the Universal Plugin Manager's (UPM) REST API to deploy apps (formerly known as add-ons or plugins) to a remote Confluence server. It is a tool for developers to deploy a number of JARs/OBRs to an environment, like development, test, pre-production. The plugin may operate on a single project, handling the artifact of this project, or may be based on a POM project that defines a set of apps to be deployed to different environments.

For more information please visit the tool's website !

Improvement

  • [APPMP-5] - Support local and global Parameters
  • [APPMP-6] - Rename Parameter allowSnapshots to requireReleases
  • [APPMP-7] - Rename Mojos / Goals for Checks

Today we published a bugfix release for the smartics JIRA Maven Plugin in version 0.2.1.

The smartics JIRA Maven Plugin supports updating information on a JIRA server to integrate into our Maven build process.

This plugin is one additional building block for the automation of process around the projectdoc Toolbox for Confluence. Together with the Doctype Maven Plugin and the Apptools Maven Plugin this is the third plugin to make daily tasks simple and fast to execute.

None of the plugin goals requires a POM file to be present. In case such a POM file or the Maven Settings file is present, information (like the URL to the issue management system or the credentials for the JIRA server) will used.

Currently the following use cases are supported:

  1. Adding new versions from the commandline
  2. Adding issues that depend in a root issue from the commandline (such as there is a new feature in the Doctypes MP and we need to add issues in the Doctype Add-ons)

Checking differences between the Maven POM and the JIRA Project (because the REST Client API does not support more currently)

Release Notes 0.2.1

Bug

  • [SJMP-3] - Check skip
  • [SJMP-4] - Fix Homepage URL in Usage Mojo

Improvement

  • [SJMP-1] - Support local and global Parameters
  • [SJMP-2] - Compatibility Update Guava

Resources

More information about the smartics JIRA Maven Plugin.

smartics JIRA Maven Plugin 0.2.0
Blog article with some usage samples for the first published version of the plugin.



Today we released the first public version of the SJMP! Its current version is 0.2.0, so expect that there are some rough edges and plenty of use cases still unsupported.

The smartics JIRA Maven Plugin supports updating information on a JIRA server to integrate into our Maven build process.

This plugin is one additional building block for the automation of process around the projectdoc Toolbox for Confluence. Together with the Doctype Maven Plugin and the Apptools Maven Plugin this is the third plugin to make daily tasks simple and fast to execute.

None of the plugin goals requires a POM file to be present. In case such a POM file or the Maven Settings file is present, information (like the URL to the issue management system or the credentials for the JIRA server) will used.

Currently the following use cases are supported:

  1. Adding new versions from the commandline
  2. Adding issues that depend in a root issue from the commandline (such as there is a new feature in the Doctypes MP and we need to add issues in the Doctype Add-ons)
  3. Checking differences between the Maven POM and the JIRA Project (because the REST Client API does not support more currently)

We also have the help and usage goal to support users directly on the commandline.

The main use case for us us is to created related issues. If we have a new feature with our Doctype Maven Plugin that generates a new artifact into existing doctype add-ons or fixes a bug on generated artifacts, then users of these add-ons need to be informed. This is typically done by adding a new issue to the individual doctype add-on projects, explaining briefly that this new feature exists or an issue has been solved. With this plugin the related issues can be created automatically, link to the root issue, and be set to a fixed state. No manual steps involved.

Use Cases

So here are some usage examples with goals of this plugin.

Use Dry Run!

 

Use -DdryRun to check what will be executed and changed on JIRA without actually changing anything!

Add Versions

Run

mvn smartics-jira:versions 

on a project to add the current version and the next micro, minor, and major version on JIRA.
For instance, if your project is currently in version 2.3.1-SNAPSHOT, running the above command will ensure that the related project (identified with the issue management in your project's POM) on your JIRA server will have versions 2.3.12.3.2 (next micro), 2.4.0 (next minor), and 3.0.0 (next major) configured. If any version already exists, that's fine. If not, it will be created.

See Update Versions for more details.

Sync Project

Run

mvn smartics-jira:sync 

on a project to check the differences in name, description, and URL between this information in the POM and on the JIRA project.

Create dependent Issues

Run

mvn smartics-jira:issues -DrootIssue=MYPROJ-1 -DprojectKeys=MYOTHERPROJ1,MYOTHERPROJ2

to create dependent issues in upstream projects. This is useful if a change in one project has positive effect, like fixing a bug or adding a new feature, without the other projects needing to be touched.

In version 0.2.1: Local and global Parameter Names

 

Note that each parameter you specify on the command line may be made unique with the prefix smartics-jira (e.g. smartics-jira.projectKeys) with the next version of this plugin.

To keep the command line short, the prefix is not necessary.