Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

[Bug] It's hard to find latest docs using search engines like Google

See original GitHub issue

Search before asking

I searched in the issues and found nothing similar.

Version

Minimal reproduce step

What did you expect to see?

Documentation for the lastest version of Pulsar.

What did you see instead?

The latest version of Pulsar is 2.10.x, but I see docs for 2.3.2. I constantly see the documentation for random old versions of Pulsar.

Anything else?

It should be possible to fix it by adding the following HTML meta tag to all pages for old Pulsar versions docs.

<head>
  <meta name="robots" content="noindex, nofollow" />
</head>

If you are using Docusaurus, it should be doable by conditionally adding required meta tag to its config file:

https://docusaurus.io/docs/seo

After a couple of weeks, Google should reindex these pages.

More info

Are you willing to submit a PR?

I’m willing to submit a PR!

Issue Analytics

State:
Created a year ago
Comments:12 (8 by maintainers)

Top GitHub Comments

1reaction

michaeljmarshallcommented, Oct 28, 2022

This is an important issue to solve. In addition to discoverability, we often expose old docs. For example, when I search pulsar java admin client, the second result is for incubator docs.

Screen Shot 2022-10-28 at 10 25 31 AM

Note that the first link is for the java client, not the java admin client. If you dig into the java client page, it points to the admin client. However, I have heard from users that it was hard to find the admin client documentation.

1reaction

visortellecommented, Oct 25, 2022

@ishu-thakur I think you should somehow conditionally configure the Docusaurus config instead of adding the meta tag in every html file.

If you take it, it’s your task to find out how to do it in a better way.