Skip to content

Conversation

vitek-karas
Copy link
Member

@vitek-karas vitek-karas commented Aug 26, 2021

Hosting .NET through coreclr.h has been obsolete since .NET Core 3.0 and should not be used.

All the versions which needed it (.NET Core 2.2 and older) are now out of support.

Having the coreclr.h hosting available in the docs and samples is confusing and may lead people to actually use it for newer runtimes which can lead to unexpected results.

This change removes the sample code and modifies the hosting guide to only mention one hosting API. I added a note about the older runtimes needing to use coreclr.h but intentionally didn't include any details on that topic.

It also updates the hostfxr sample with a fresh copy of the sample from the samples repo.

Corresponding changes to samples: dotnet/samples#4786.

Hosting .NET through `coreclr.h` has been obsolete since .NET Core 3.0 and should not be used.

All the versions which needed it (.NET Core 2.2 and older) are not out of support.

Having the `coreclr.h` hosting available in the docs and samples is confusing and may lead people to actually use it for newer runtimes which can lead to unexpected results.

This change removes the sample code and modifies the hosting guide to only mention one hosting API. I added a note about the older runtimes needing to use `coreclr.h` but intentionally didn't include any details on that topic.
Copy link
Member

@elinor-fung elinor-fung left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would it make sense to do a general .NET Core runtime -> .NET runtime conversion (except for where it is explicitly .NET Core 3.0) throughout this tutorial?

vitek-karas and others added 3 commits August 27, 2021 09:15
Co-authored-by: Elinor Fung <elfung@microsoft.com>
Co-authored-by: Mateo Torres-Ruiz <mateoatr@users.noreply.github.com>
@vitek-karas
Copy link
Member Author

dotnet/samples#4790 moves the sample one level up in directory - this change already reacts to that and updates the link.

@vitek-karas vitek-karas merged commit 4b7621b into dotnet:main Aug 27, 2021
@vitek-karas vitek-karas deleted the RemoveCoreClrHosting branch August 27, 2021 20:11
@Earthman100
Copy link

Thats what dot net is made from! no outdating that!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants