Create an OS onboarding doc

[richlander]

We should create a new OS onboarding doc. I think it will be of significant benefit.

We have been working on one for dotnet/runtime. I suspect such a doc for dotnet/aspnetcore would be significantly shorter. At the very least, we need such a doc for a native code repo and another for a managed code only one so that all other repos can use our smart thinking as guidance.

Want to work on this together @wtgodbe? I suspect it won't take very much time at all. Most of it should be codifying what we did at #60260.

Related: dotnet/runtime#112026

[wtgodbe]

Want to work on this together @wtgodbe? I suspect it won't take very much time at all. Most of it should be codifying what we did at #60260.

Sure! By onboarding, do we mean "Ensuring aspnetcore can be built for & ran on the new OS", and we just need a doc to explain the mechanical steps of doing so in aspnetcore?

[richlander]

Right. I think (A) aspnetcore is much simpler than runtime and (B) most other repos are like aspnetcore.

[wtgodbe]

Cool - would you be happy with something that:

• Links to the doc in runtime for more broad context about our OS philosophy
• Links to this doc for instructions on spinning up a docker container
• Spells out the specific mechanical steps for adding build/test jobs on the new container in aspnetcore

? If so I can whip something up

[richlander]

Yes.

There are two big things:

• Which files to edit with some sample PRs (much like the runtime doc does)
• For managed code, we cross-compile via the SDK (rids and such) and can use one container images for that (Azure Linux x64). This is in contrast to the heavy-lift cross-compiling method the runtime uses. It's so nice to just have C#!

[richlander]

Here's the final URL to the other doc.

https://github.com/dotnet/runtime/blob/main/docs/project/os-onboarding.md