Skip to content

Conversation

@psantos1113
Copy link
Collaborator

@psantos1113 psantos1113 commented Nov 13, 2025

In order to fix the issues with links the old inline format of creating links like standard markup does not work for Jira Cloud. The content for descriptions and comments must follow the Atlassian Document Format now for Jira Cloud.

The old way of creating links like this [text](http://link.example.com) no longer works.

In order to fix the issue we must produce an Atlassian Document Format object, which is already implemented in the int-jira-common library, for the description and comments.

This MR has a number of changes to do that. This issue highlights that the way in which data is formatted for the various channels is a design that is overly complex with too many layers of abstraction that needs to be re-designed in the future.

In order to isolate the fix to just Jira Cloud a number of classes that exist in the com.blackduck.integration.alert.channel.jira.cloud.convert package are copies of the original classes in the api-channel-issue-tracker sub project. These classes have the code changes to produce a model that represents the Atlassian Document Format for issues.

The main class that actually creates the Atlassian Document Format model is the class: AtlassianDocumentBuilder. This is a stateful class that allows more text and paragraph nodes to be added to the document model in order to display the content that way it used to appear using the stringbuilder approach. The build methods will build the primary document and build any additional documents that are used to create comments on the issue.

Also note the JiraCloudIssueCreator, JiraCloudIssueCommenter, and JiraCloudIssueTransitioner needed to be changed in order to pass in the model object that represents the Atlassian Document Format.

@psantos1113 psantos1113 requested review from ChomickiM and DanaMaxfield and removed request for ChomickiM November 14, 2025 15:28
@psantos1113 psantos1113 marked this pull request as ready for review November 14, 2025 15:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants