Readability Whitelisting now Live for VisibleThread Docs

Readability Whitelisting now Live for VisibleThread Docs

We pushed “Readability Whitelisting” live earlier this week on our cloud servers. For on-premise users, this will be a part of our next release.

What does Readability Whitelisting do?

It allows VisibleThread Docs users exclude certain phrases from both readability calculations; Readability and Grade Level.

To be concrete, let’s assume you are an organization operating in a technical domain, you might have complex phrases that you must use. These will however skew your readability score negatively. So you might want to ignore those phrases from your readability scores.

  • For example, let’s say you need to use: ‘electromagnetic conduction’ in your copy. You just whitelist that phrase, meaning the words will be counted in our readability calculation but the syllable count will be set low for each word.
  • The net effect is that if you have a lot of heavily tech content, without whitelisting, your readability scores will tend to skew negatively. Whitelisting neutralises that. So you can focus on the areas where you can simplify.
  • Here’s another example; let’s say the name of your organization has lots of syllables in it (which will skew the readability scores). For example; the ‘Department of Immigration and Naturalization’. If you whitelist that full phrase, then ‘Immigration’ does not count as 4 syllables and ‘Naturalization’ does not count as 6 syllables.

What this means for existing VisibleThread Docs users:

1. What’s changed? You will see this new messages when you go into Clear Language.

This will occur for every folder or doc when you select Clear Language.

Why do I need to re-analyze? Because we have changed the underlying data structure to support whitelisting, so we just need to re-analyze to expose this new capability.


2. Once you re-analyze (for older folders/docs), you will see some new options:
Readability Whitelist
3. How can the user tell what is whitelisted in this document?
If we found whitelisted terms, then you see a message like this. In this example ‘organization’ appeared 12 times in the doc:
4. Where is the whitelist maintained?

We manage the whitelist at the environment level (i.e. at sandbox level). This means that the same whitelist applies to all folders. And all users share the same whitelist.

5. What happens when you make changes to the whitelist?

If you edit the whitelist, you will need to re-analyze all folders. You will see this message when you select the ‘Clear Language’ tab:

Re-analysis will be very fast

We hope you enjoy this new capability. Any questions on this, just contact our support team.

Many thanks,

Eoin Wren,

VP Engineering and Support.