Improve Google search results

[james-s-w-clark]

Problem

For some (less visited?) pages on the Mill website, Google searches can send you to really old versions of documentation.

For example, "mill contrib proguard" gives you the 0.9.9 (> 1 year old docs) in the first Google result. The second google result is 0.10.3.

We want our users to get the best information possible, so they get the most value from mill. I expect this would mean giving them information on the latest stable version of mill (0.10.5 at the time of writing).

Out of curiosity, DuckDuckGo gives the very latest build of the site - but as the 4th result. I imagine Google hasn't done a full index of the site for a while.

Solution

I see we are using Antorra for the website (antora.yml) to get multiple versions of docs.

I asked Antora if they have any tips on how to improve internet searches.

There's a couple suggestions:

• Link to latest version of the docs (like how Spring 5.7.1 warns that a 5.7.2 version of the page is out)
• in Google Search consoles, re-index/scan the site

---

What do you think?