AndroidX icon indicating copy to clipboard operation
AndroidX copied to clipboard

Remove "Xamarin." from Package Descriptions

Open jonpryor opened this issue 3 years ago • 1 comments

Android application type

Android for .NET (net6.0-android, etc.)

Affected platform version

.NET 6.0+

Description

Context: https://github.com/dotnet/maui/issues/10234#issuecomment-1254681019 Context: https://nuget.info/packages/Xamarin.AndroidX.Browser/1.4.0.2

Our package names and descriptions are confusing people. Some customers are under the apparent (mistaken) impression that "Xamarin" packages can't be -- or shouldn't be -- used with .NET apps.

Our package descriptions don't help with that impression; consider https://github.com/dotnet/maui/issues/10234#issuecomment-1254681019, in which a customer says that it's "quite weird" to reference Xamarin packages, "since this is a MAUI project".

Their screenshot shows the Xamarin.AndroidX.Browser package (among others):

Xamarin.AndroidX.Browser by Microsoft Xamarin.Android bindings for AndroidX - browser artifact=androidx.browser:browser artifact_versioned=androidx.browser:browser:1.4.0

We don't want to rename the package names (though that would be the "easiest" way to address this confusion).

Proposal/question: Would it help if we changed the package description to explicitly mention .NET?

Instead of:

Xamarin.Android bindings for AndroidX - browser artifact=androidx.browser:browser artifact_versioned=androidx.browser:browser:1.4.0

we instead have:

.NET bindings for the AndroidX browser maven artifact

Implicit in this suggestion is the removal of "artifact=…" from the description. The purpose to this metadata is to make it easier to search NuGet.org from "binderator" (and other future tooling) for bindings of existing/detected packages. Does this metadata need to be in the user-visible description? Or can it be moved "somewhere else" within the NuGet metadata, so that it can still be searched for, but is not shown to developers?

Relevant log output

No response

jonpryor avatar Sep 22 '22 19:09 jonpryor

In order not to go in opposite extreme (by removing Xamarin) the metadata was changed to

.NET for Android (formerly Xamarin.Android)

This way old users with legacy Xamarin apps will be notified that packages still support Xamarin technology (Xamarin.Forms and other).

https://github.com/xamarin/AndroidX/pull/623

moljac avatar Oct 12 '22 10:10 moljac

bumped packages waiting review and approval.

moljac avatar Oct 24 '22 14:10 moljac

done

moljac avatar Nov 04 '22 19:11 moljac