Acrolinx Release Notes (including subsequent service releases)

Version 2019.10 (27 September 2019) Acrolinx Private Cloud, Standard Stack, and On-Premise

Summary

In this release, we've introduced support for DITA reference checking – thank you for your patience! – along with some other improvements and bugs fixes. And we've got two new API endpoints!

If you're an On-premise customer, catch up with all the other changes that have been happening in the 2019.07, 2019.08, and 2019.09 release notes.

New Features

DITA in Oxygen

For those of you using DITA in Oxygen, we’ve got some great news! We've introduced support for DITA reference checking in Oxygen. You can now use Oxygen to check different kinds of referenced content. This includes:

  • conkeyrefs
  • conrefs
  • keyrefs
  • topicrefs

We include the content in these references as part of your Acrolinx Score. For more on what we support in our latest Oxygen release, keep your eyes peeled for our 1.5 Oxygen release notes, which are coming soon.

The Content Analyzer doesn’t resolve these references, so you may get a different Acrolinx Score based on which integration you’re checking from.

Server Monitoring APIs

We have two new API endpoints that help you monitor your Acrolinx instance: General Health, and Checking Metrics.

General Health shows which languages have a language server up and running.

Checking Metrics contains metrics about received, successful, and unsuccessful checks.

To access these endpoints, you'll need the new Access to monitoring API privilege.

If you have the "Access to monitoring API" privilege, you can access the endpoints in the following ways:

EndpointResponse
/api/v1/monitoring/healthGeneral Health – which languages have a language server up and running.
/api/v1/monitoring/checksChecking Metrics – metrics about received, successful, and unsuccessful checks.

You can find more details about these endpoints in our API documentation.

Placeholders in the Scorecard for Excluded or Empty Elements

We now mark excluded or empty elements with an ellipsis symbol ('…') in the Scorecard. We already use the ellipsis symbol as a placeholder for excluded or empty elements in the Sidebar, so this should feel familiar.

This feature is only active if "Mark excluded elements" is turned on in the relevant Content Profile.

Improvements

Improved Message for Protected Content

Sometimes, the Sidebar can't replace issues for you. This can happen when your content is protected, or there’s a limitation with your integration. We now have an improved message that lets you know when the Sidebar can't replace issues for you. You'll see it as a tooltip when you hover over the padlock at the top of the Sidebar.

New Inline Tutorial: Guidance Overview

We have a new inline tutorial for you: Guidance Overview. It guides you through the Guidance Settings section of the Dashboard, with links to relevant documentation. We hope you find it helpful - let us know!

Changes

Changes to Confidentiality Feature Documentation

We wanted to reiterate changes to our confidentiality feature and let you know of the updates in the Product Documentation. In the last few releases, we put a lot of effort into improving security. We made sure that we don't write any files to disk.

We don't write files anywhere for confidential checks and you won't find information about confidential checks in the server workload capture.

‘Delete User Sessions and Access Points’ Privilege Has Changed to 'Release User Licenses'

We've renamed the privilege 'Delete user sessions and access points' to 'Release user licenses'. You'll need this privilege to manage your users and release any inactive user licenses. 

Bug Fixes

Term Contribution Was Broken for Simplified Technical English

If you checked with Simplified Technical English (STE), you may have come across an error when trying to contribute a term from the Sidebar Term Discovery tab. We’ve fixed this by creating the language category dynamically when a term is being contributed for a language that doesn't yet exist.

Check Selection Returned "Where's the Text?"

This issue only appeared in 2019.08. You might have seen the error 'Where's the Text?' when you checked a selection towards the end of structured content. We've taken care of this scenario.

Track Changes Inserted Invisible Sentence Breaks

When the Track Changes feature is enabled, Microsoft Word inserts some extra <p> elements wherever a change is made. Because <p> is set to be a sentence breaker in most Content Profiles, this caused non-issues when checking. We've fixed this one. 

Connection Reset When Loading Certain Term Sets

In very rare cases, some customers experienced a connection reset when the language server loaded certain term sets. This only happened when the language server was running on Windows Server 2016. We've fixed this one too.

Guidance Overview Dashboard - "Preferred" Terms Included Valid Terms and Deprecated Variants

The Terminology Issues chart in the Guidance Overview dashboard combined two different types of issues – issues from valid terms, and issues from deprecated variants of preferred terms. We think that this doesn't really make sense. 

We’ve updated the term statuses that you see in Analytics to more closely match what you see in the Sidebar, especially for variants of preferred terms.