Search lists legacy clients before current ones

[petrkoutnycz]

Core or SDK?

Platform/SDK

Which part? Which one?

C# client

Description

I was looking for a recommended C# client to use with Sentry product, but the mentioned one (SharpRaven) appears to be deprecated.

Suggested Solution

Recommend the new nuget - https://www.nuget.org/packages/Sentry/

[imatwawana]

@petrkoutnycz - where did you see this recommendation?

[petrkoutnycz]

Here: https://docs.sentry.io/clients/csharp/

[getsentry-release]

Routing to @getsentry/team-mobile for triage. ⏲️

[imatwawana]

@getsentry/team-mobile-cross-platform - Making an educated guess that y'all can help with this based on the only other SDK on that page being .NET, but I can only tag Team: Mobile Platform.

[mattjohnsonpint]

That's the page listing legacy clients, is labeled as such, and already says to use the newer .NET SDK in the red box at the top of the page.

I'm less interested in changing this page and more interested in how you got there to begin with. Was it as the result of a search? Or were you specifically looking for the older client?

[petrkoutnycz]

@mattjohnsonpint it was a result of search by query "sentry c# client". I dont have any intention in finding legacy clients :-) PS: I dont see any other clients on the website besides legacy ones anyway. Even if I search on your website, I see legacy ones first

[mattjohnsonpint]

Ouch, yeah it's pretty bad that is the first Search result. Though it also depends which page you are on when you search, but still. Even the main page gives that.

On the Google search, it seems the legacy client is listed first and the modern client is listed second.

Thanks for reporting this. We have lots of issues with both internal search and SEO, but this one seems pretty important to resolve.

[mattjohnsonpint]

@imatwawana - not sure how you want to route this. It's both a docs-search and SEO issue.

[mattjohnsonpint]

I changed some of the text on the .NET docs to hopefully change these specific search results, but I still think it highlights some of the issues we have with search in general.

[imatwawana]

@mattjohnsonpint - Just wanna circle back to the original issue that was raised and I'll address the search stuff in a separate comment; should that first link on the legacy client C# page be pointing somewhere else if you someone does still need to use this client?

[imatwawana]

So, just searching "clients" somewhat understandably points to the legacy pages because that's where we use that terminology right in the URL. I'll have to do some digging as to the best way to approach the terminology issue and we can talk to the SEO folks about any ideas for improving the Google results. However, when I search "C# client" in the Docs, the first result I get is .NET:

[mattjohnsonpint]

The nuget link is pointing at the correct place for SharpRaven (the legacy client).

Also, the change I made might have improved some of the search results already, so that is good.

Thanks.

[stephanie-anderson]

This was resolved by fixing the noindex functionality in the SEO component in here: closes https://github.com/getsentry/sentry-docs/pull/7007

Search can respect this settings now:

And Google did also pick up on it: