Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Note

This feature is available only for the cloud version of ARN.

Release pages

Release page is the easiest way to publish release notes or changelog on a public page. Once the release page set up setup is saved and rules are configured, the release page is updated whenever configured rules are triggered.

Create release page

Expand
titleCreate release page

Refer to the Step by step guide to Release pages & Widgets

Edit release page

Expand
titleEdit release page

Clicking on the name of the existing release page brings you to the edit screen. It is exactly the same as createcreating, only that the existing data is pre-populated & can be modified.

Note that, issue details in 'Release page content layout' section cannot be modified if there are one or more releases associated with that release page. Observe the message displayed below.

Image RemovedImage Added

The only way to modify these fields is to delete existing releases from the release page & then come back to edit release page to update issue details.

Delete release page

Expand
titleDelete release page

Clicking on the ‘Trash’ Trash icon on the release pages listing section will trigger the ‘Delete’ Delete action. Note that, the release page can be deleted only after it has been removed from any rule actions.

Deleting a release page is irreversible.

Release page subscription

Expand
titleRelease page subscription

Release page subscription lets users subscribe to your release page updates. They stay informed through automated email notifications when new release is posted on the release page.

To enable subscribe button on your release page, go to release page configurations page & enable ‘Allow Allow new subscribers’ subscribers toggle.

When user clicks on subscribe Subscribe button on release page, they will be prompted to enter their email address. User will get an email to confirm their subscription. Upon confirmation of subscription by the user, they will be added as active subscriber for your release page.

Image RemovedImage Added

Automated notifications to subscribers

You can enable automated email notifications to the subscribers by enabling ‘Send Send updates to subscribers’ subscribers toggle shown in above image.

When you enable this toggle, you need to map a release page notification template and select send via email (default email Id or custom email configured through SMTP settings). Every time a new release is updated on the release page, an automated email notification will be sent to all active subscribers.

Release page notifications email template

For release page notifications, we have introduced a new type of email template called ‘Release Release page notifications’notifications. This template can be added from the templates tab.

'Release page notifications' template can be mapped in the release page configurations explained above. This type of template shall not be available for mapping under any other rule actions.

Image RemovedImage Added

Widgets

Widget is a brand new way to communicate release notes directly with your customers. It lets you embed the release notes in the form of a widget, directly in your web or mobile app. Once configured, you get a Javascript snippet that can be added to any HTML page for the widget to appear.

Create widget

Expand
titleCreate widget
Image Removed

In the ‘Widget details’ section, add the following information for the widget.

Image Removed
  • Name - e.g. Admin web-app widget. Note that this name will not be shown anywhere on the widget, it is only for your reference.

  • Description - e.g. We have used this widget in the Admin web-app. Note that this description is not shown anywhere on the widget, it is only for your reference.

  • Enabled - This toggle dictates whether the widget is loaded into the web-app or not. For whatever reason, if you wanted to prevent the widget from loading - just turn this off.

In the ‘Widget content layout - Template 1’ sections, add the following attributes

Image Removed
  • Release details

    • Title - Any title that relates to the release

    • Subtitle - Any subtitle that relates to the release

  • Issue details - Select any 3 Jira issue fields here. These fields will be displayed in the widget along with information relevant to these fields. Currently, only a simple layout that makes use of these 3 fields is available. Each of those three fields are Jira issue field selectors. One can choose either default attributes or even the custom ones.

Title & Subtitle can contain variables. Note that this section is not used anywhere currently. But we will enhance the issue layouts to make use of this information. Read Release page & Widget templates for more details.

Additional details like look & feel are configured under the ‘Details’ tab of the right-hand side section.

Image Removed
  • Show default launcher - This toggle identifies whether the widget launcher is available on-screen by default. If disabled, the launcher won’t be displayed until made visible by another action.

  • Widget launcher label - e.g. Release notes. This is what the button text will be, to open/close the widget.

  • Widget launcher button size - Small, Medium, Large

  • Rest of the configurations deal with the look & feel of the widget

Image Removed

In the ‘Widget content’ a JQL is defined that that determines what data is populated within the widgets. Every time the widget action is triggered, it will look at the JQL & pull out the relevant issues. Similar to how the JQL section is configured, you can use variables in this text box.

Image Removed

Once the JQL is added, click anywhere outside of the box & (tick) or (error) will be displayed to convey correctness of the JQL.

A sample JQL that can be used:

Project = ARN AND issueType = “New Feature” AND fixVersion = “[versionName]”

Image Removed

Embed code

Once all the mandatory information is filled in & ‘Save’ button is clicked - the Embed code becomes available.

Image Removed
Expand
titleEdit widget

Referr to https://amoeboids.atlassian.net/wiki/spaces/ARN/pages/2592931916/Step+by+step+guide+to+Release+pages+Widgets#Widget---Step-by-step-guide to know how to create a widget.

Edit Widget

Expand

Clicking on the name of the existing widget brings you to the edit screen. It is exactly the same as create, only that the existing data is pre-populated & can be modified.

Note that, template fields cannot be modified if there are one or more releases associated with this widget. Observe the message displayed below.

Image RemovedImage Added

The only way to modify field mapping is to delete existing releases from the widget & then come back to update field mapping.

Delete widget

Expand
titleDelete widget

Clicking on the ‘Trash’ Trash icon on the widget listing section will trigger the ‘Delete’ Delete action. Note that, the widget can be deleted only after it has been removed from any rule actions.

Deleting a widget is irreversible.

Further reading

Child pages (Children Display)
pageRelease pages & widgets

On this page

Table of Contents
minLevel2
maxLevel46
outlinefalse
stylesquare
typelist
printablefalse

Iframe
scrollingauto
srchttps://amoeboidsform.typeform.com/c/loItQqk5?typeform-cui-avatar=https://images.typeform.com/images/RsZMyNqkfNcY#url=/spaces/ARN/pages/1657700370/Release+pages+widgetsto/loItQqk5#url=xxx
width350
frameborderhide
alignmiddle
height250

Request support👨‍💻

Leave us a review(green star)