1
0
Fork 0
mirror of https://github.com/VSadov/Satori.git synced 2025-06-11 02:13:38 +09:00
Satori/docs
Aleksey Kliger (λgeek) e629779764
[cdac] Physical contract descriptor spec (#100365)
Building on #100253 , describe an in-memory representation of the toplevel contract descriptor, comprisied of:
* some target architecture properties
* a data descriptor
* a collection of compatible contracts

Contributes to #99298 
Fixes https://github.com/dotnet/runtime/issues/99299

---


* [cdac] Physical contract descriptor spec

* Add "contracts" to the data descriptor

*  one runtime per module

   if there are multiple hosted runtimes, diagnostic tooling should look in each loaded module to discover the contract descriptor

* Apply suggestions from code review

* Review feedback

   - put the aux data and descriptor sizes closer to the pointers

   - Don't include trailing nul `descriptor_size`.  Clarify it is counting bytes and that `descriptor` is in UTF-8

   - Simplify `DotNetRuntimeContractDescriptor` naming discussion

---------

Co-authored-by: Elinor Fung <elfung@microsoft.com>
2024-04-04 10:39:49 -04:00
..
coding-guidelines Fix format.sh script and remove dotnet-format tool from dotnet-tools.json (#94839) 2023-11-16 15:38:39 +01:00
design [cdac] Physical contract descriptor spec (#100365) 2024-04-04 10:39:49 -04:00
infra FabricBot: Onboarding to GitOps.ResourceManagement because of FabricBot decommissioning (#99169) 2024-03-06 22:39:50 -08:00
issue-mappings Old repo issue number mapped to new repo issue number (#31981) 2020-02-08 12:20:38 -08:00
project Move last P/Invoke error from native Thread and delete C/C++ SafeHandle implementation (#100267) 2024-03-27 06:14:44 -07:00
tools/illink Use Program.dll instead of Program.exe in illink docs (#95752) 2023-12-08 20:52:37 +01:00
workflow Remove requirement for building packs to run host tests and infrastructure around restoring test project assets (#100324) 2024-03-29 12:25:24 -07:00
area-owners.md Update codeowners (#100165) 2024-03-22 18:19:13 -05:00
deep-dive-blog-posts.md Add Performance Improvements in .NET 8 to deep-dive-posts.md (#92003) 2023-09-13 11:26:06 -04:00
issue-cleanup.md Add issue cleanup documentation and update automation (#69857) 2022-05-30 11:34:44 +01:00
issues-pr-management.md Quick doc formatting update to test checkout without bundle. 2021-01-14 11:28:34 -08:00
README.md Delete broken link (#93378) 2023-10-12 08:39:07 -04:00

Documents Index

This repo includes several documents that explain both high-level and low-level concepts about the .NET runtime and libraries. These are very useful for contributors, to get context that can be very difficult to acquire from just reading code.

Intro to .NET

.NET is a self-contained .NET runtime and framework that implements ECMA 335. It can be (and has been) ported to multiple architectures and platforms. It support a variety of installation options, having no specific deployment requirements itself.

Getting Started

Workflow (Building, testing, benchmarking, profiling, etc.)

If you want to contribute a code change to this repo, start here.

Design Docs

The Book of the Runtime is a set of chapters that go in depth into various interesting aspects of the design of the .NET Framework.

For your convenience, here are a few quick links to popular chapters:

For additional information, see this list of blog posts that provide a 'deep-dive' into the CoreCLR source code

Coding Guidelines

Project Docs

To be added. Visit the project docs folder directly meanwhile.

Other Information