Add unsafe-code/best-practices.md

[EgorBo]

Summary

The document contains best practices when dealing with Unsafe code in .NET (focusing on C#), a set of common unreliable patterns and how to avoid them. Some background on why we do this is described here: dotnet/designs#341

We were using https://learn.microsoft.com/en-us/dotnet/standard/native-interop/best-practices as an inspiration for this doc.

cc @jkotas @richlander

---

Internal previews

📄 File	🔗 Preview link
docs/navigate/advanced-programming/toc.yml	docs/navigate/advanced-programming/toc
docs/standard/unsafe-code/best-practices.md	docs/standard/unsafe-code/best-practices

[hamarb123]

Other than the comments I made on discord, looks good to me :)

[EgorBo]

@jkotas anything else here from our side?

[jkotas]

This needs to be reviewed and signed off by the doc maintainers before merging. It looks good to me otherwise.

[EgorBo]

@gewarren thank you so much for the corrections! I learned a lot 🙂 I believe, I've addressed all of your requests.

[gewarren]

A few xref fixes. I'll commit these.

[EgorBo]

@gewarren ah, thanks, I already fixed them locally (just pushed) via that extension that you recommended

[gewarren]

@gewarren ah, thanks, I already fixed them locally (just pushed) via that extension that you recommended

Nice, that was my hackathon project last year :)

[EgorBo]

@gewarren ah, thanks, I already fixed them locally (just pushed) via that extension that you recommended

Nice, that was my hackathon project last year :)

Awesome! It does look handy.

Regarding the PR, who typically merges the PRs?

[gewarren]

Regarding the PR, who typically merges the PRs?

Me or one of the other content devs (or you if you have write perms). I'll merge it now. Thanks for adding this doc!

[richlander]

Thanks much!

[Frulfump]

Here's the live link for anyone like me who was looking for it
https://learn.microsoft.com/en-us/dotnet/standard/unsafe-code/best-practices