Full revision of rid catalog topic for 2.0 #3079
Conversation
mairaw
requested review from
janvorli,
ericstj,
weshaggard,
livarcocc,
Petermarcu and
eerhardt
docs/core/rid-catalog.md
Outdated
| compatibility statements. That means that a RID that has an imported RID in it can be a target for restoring packages | ||
| for that RID. Slightly confusing, but let's look at an example. Let's take a look at macOS: | ||
| RID is short for *Runtime IDentifier*. RID values are used to identify target platforms where the application runs. | ||
| They're used by .NET packages to represent runtime-specific assets in NuGet packages. The following values are examples of RIDs: `linux-x64`, `ubuntu.14.04-x64`, `win7-x64`, or `osx.10.11-x64`. |
There was a problem hiding this comment.
Its not "runtime specific assets", it's "platform specific assets".
docs/core/rid-catalog.md
Outdated
| When NuGet restores packages, it tries to find an exact match for the specified runtime. | ||
| If an exact match is not found, NuGet walks back the graph until it finds the closest compatible system according to the RID graph. | ||
|
|
||
| The following example is the actual entry for the `osx.10.11-x64` RID: |
There was a problem hiding this comment.
May be better to use a platform that is still supported? 10.12?
| > [!NOTE] | ||
| > We are working towards getting this information into a more interactive form. | ||
| > When that happens, this page will be updated to point to that tool and/or its usage documentation. | ||
| To be able to use RIDs, you have to know which RIDs exist. New values are added regularly to the platform. |
There was a problem hiding this comment.
There is a way for a package to extend the graph if needed. Should we doc that?
There was a problem hiding this comment.
@robrrelyea / @emgarten? I recall that previous NuGet owners didn't want to doc this. Now with the prevalence of distros we may need to.
There was a problem hiding this comment.
Dependencies through runtime.json is considered something that only system packages should use. I'm not sure on the RID graph itself which is also part of runtime.json.
There was a problem hiding this comment.
I'm a bit confused on what exactly to do here. cc @rrelyea
|
Let's make this part of Netcore 2.1 planning process if this change is a significantly important change to ask of Nuget. Would have to balance with other asks. |
docs/core/rid-catalog.md
Outdated
| - `debian.8-x64` | ||
| - Fedora | ||
| - `fedora-x64` | ||
| - `fedora.23-x64` |
There was a problem hiding this comment.
I think we can remove fedora.23 and opensuse.13.2 since they've been "end of life'd".
Fixes #2843
Internal Review URL