search

ericsink / SQLitePCL.raw

A Portable Class Library (PCL) for low-level (raw) access to SQLite
Apache License 2.0
512 stars 106 forks source link

Link to the Nuget package #585

Closed xafero closed 4 months ago

xafero commented 5 months ago

My journey was:

  1. Read the Microsoft documentation, find "sqlite-net-pcl"
  2. Open it in Nuget, finding version 1.8.116
  3. Searching again for the name, finding this Github repo
  4. Now reading here the only link to Nuget as "sqlite-net-pcl" again
  5. Wondering why repo says 2.x and that package has 1.8.x
  6. Reading about "Microsoft.Data.Sqlite" here, that it uses PCLRaw, too
  7. Open it in Nuget, finding version 8.0.1 uses "SQLitePCLRaw.core", which has version 2.1.7

Am I the only one? If someone reads official docs, then finds this Git repo, and still wants to use SQLitePCLRaw without another wrapper around it, then I would have used the wrong Nuget package. Recommending a "raw" package to any user should be a no-go in my eyes. If you don't know this "raw" thing, you ain't gonna need it, I would suppose.

Can you give some guidance to this or am I the only one to ever wonder about versions and links?

ericsink commented 5 months ago

I am confused by your story of how you were confused. :-)

Yes, there are multiple Nuget packages in your story. SQLitePCLRaw (actually a collection of packages) is a dependency of the other two, sqlite-net-pcl and Microsoft.Data.Sqlite. They're all distinct, maintained by different people or organizations, which (in part) is why they have different version numbers. I maintain SQLitePCLRaw, and I don't have any control over the other packages or the Microsoft documentation.

If you are suggesting a change here in this project, please be specific.

xafero commented 5 months ago

Okay. I thought maybe have "SQLitePCLRaw.core" or something as NuGet link, because the result of the repo is pushed somewhere, I guess, if you are this guy https://www.nuget.org/profiles/ericsink