Checking Your Content for Findability
Acrolinx can check your content and tell you what keywords a search engine would probably prioritize when indexing your content — these show up as discovered keywords.
You can then see how many of your discovered keywords match up with your target keywords.
To check your content for findability, follow these steps:
- Open a document, then open the Acrolinx sidebar if it isn't open already.
- Click CHECK to check your content, discover existing keywords and get findability metrics for targeted keywords.
- Open the
TheFindability tab has two sections:
These are keywords that frequently show up in your content. There are a few metrics we use to build this list, which we'll go into further on in this section. Discovered Keywords
These are keywords that you want to target for findability. They should include the search keywords that you want your content to match against. Target Keywords
Review and analyze the keyword information to see how you can optimize your content. Findability tab and review the keywords.
- Discovered Keywords
When you review your discovered and targeted keywords, you can use the findability metrics to help organize and assess your keywords.
Here's a short explanation of those metrics:
|Frequency||The frequency metric is a measurement of the keyword count in relation to the size of the document. It's expressed as a score out of 100.|
|Count||The number of times the keyword appeared in your content.|
|Prominence||This metric measures the prominent placement of keywords in your content. Prominent placement can be in the document title, headings, or opening paragraph. Acrolinx uses a special formula to give each keyword a prominence score out of 10|
Acrolinx also warns you when there's a problem with your findability metrics. For example, when Acrolinx warns you when the prominence scores of your keywords don't match the order of priority. The following illustration explains these warnings in more detail:
|1) Yellow prominence warning|
The keyword that's above this one has a lower prominence score.
In this example, we need to make the keyword "context definition file" more prominent in the content, or drag it below the keyword "guideline" so that "guideline" has a higher priority.
|2) Red prominence warning||The keyword that's two places higher in priority has a lower prominence score than this one.|
In this example, we need to make the keyword "context definition file" more prominent in the content, or drag it below the keyword "context" so that "context" has a higher priority.
|3) Red count warning||The count is zero, so it looks like this target keyword is completely missing from the content.|
In this example, we need to add the keyword "rule" at least once in the content.
An Example Scenario
Earlier on in this article, we discussed how synonyms can increase the findability of your content. We mentioned an example of some terminology that we changed in our product content. Let's take a look at that example in more detail.
Remember that we stopped the terms "rule" as in "style rule." Instead, we say "guideline." But of course we expect most of our customers to enter "rule" as a search term when looking for help on anything related to style or grammar guidelines (formerly "rules"). If we don't include those terms in our content somehow, people will have trouble finding it.
The following illustration shows the discovered and targeted keywords for help article about content-specific guidelines.
We've highlighted some important keyword metrics in the targeted keywords list.
- The prominence of our top keyword is 0.
This is our top keyword but it's not prominent enough in the article. This might be a problem if people are quickly scanning the article to see if it's relevant for their task. We want our top target keyword to be prominent so that people can quickly see exactly what the article is about.
You can see the prominence warnings for the two keywords underneath it. As we explained in the section on warnings, these prominence warnings indicate that a keyword further up in the list has a low prominence score.
- The frequency for the keyword "rule" is 0.
This means that the keyword is completely missing from the content. It's one of our targeted keywords because it's a synonym of "guideline," but we haven't used that word in the article at all
To solve the first issue, we have to incorporate the keyword "rule" into the content without confusing the reader with inconsistent terminology. We do this by adding a note about the name change at the top of the page:
From 5.0 onwards, we refer to rules and rule sets as guidelines and writing guides.
To solve the second problem, we can change the title and introductory sentence so that they both include our top target keyword.
Configuring Guidelines So that They Only Apply to Certain Contexts
Configuring Guidelines to Be Context-specific
You can configure your guidelines so that they only apply in certain contexts.
Context-specific guidelines are guidelines that only apply in certain contexts such as titles or lists.
If we run another check, you can see that the metrics that we initially highlighted have improved.
The frequency and prominence scores for the target keywords "rule" and "context-specific" have gone up, so we've improved the findability for those target keywords.
Try using a similar method for your own content.
- Create a comprehensive list of target keywords for your piece of content.
- Make sure that the frequency is greater than zero for all target keywords.
- Make sure that the prominence scores of your top target keywords match the order in which you've prioritized them.