dotnet / dotnet/docs

Please summarize the impact of each technology on this page

Open
#27,432 0 comments 0 reactions 0 assignees View on GitHub
dotnet-fundamentals/svc
Dominant language
No language data
Stars
4.8k
Forks
6.1k
Avg merge
19h 10m
Merged PRs (30d)
268

Description

The page summarizes various performance settings, and explains _what_ they do clearly. It would be even more awesome if each subsection had also provided an two-sentence high-level summary of _when_ and _when not_:
1. What is the _adverse_ effect of each setting, for example, "This increases startup time of a program slightly" or "This improves startup time at the expense of the file size".
2. The two most prototypical scenarios that benefit, respectively, the most and the least from the setting, e. g. "This setting is beneficial for…"
* "…a long-living service process..."
* "...a program that runs through same code multiple times in a loop…"
* "…a short-living but computationally intensive utility program…"

and then "…but not for…"
* "…a command which runs through its code path once, as it would have no impact on its but increase compile time and file size."
* "…a CLI command that is repeatedly invoked in a script, because it impacts its startup time, especially on non-Windows platforms."

Engineering is, first of all, an art of compromise. I have been programming in .NET since .NET 1.0. It was easy to dig deep, know the tricks and stay current back then, as there was only the Framework, and only one platform. How many years I've had it in the top drawer of my toolbox—close to 20? About half of software I'm working on is .NET-based ([and my other Saab is C++](https://user-images.githubusercontent.com/8228229/144967155-77fb9cf3-c28b-4b65-8835-b1484159fe24.png)), and now I'm also taking it xplat into the Linux lands. Such a proliferation of the .NET family makes it harder to stay on top of this fine tech and make right perfing decision.

---
#### Document Details

⚠ *Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.*

* ID: 70b4e642-6b61-128c-3eba-2f0ca8ff440c
* Version Independent ID: 4fe316ee-08aa-2989-af97-2bfc0f698f01
* Content: [Compilation config settings - .NET](https://docs.microsoft.com/en-us/dotnet/core/run-time-config/compilation)
* Content Source: [docs/core/run-time-config/compilation.md](https://github.com/dotnet/docs/blob/main/docs/core/run-time-config/compilation.md)
* Product: **dotnet-fundamentals**
* GitHub Login: @gewarren
* Microsoft Alias: **gewarren**

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.