Document default 75% value for GCHeapHardLimitPercent in container environments

[Copilot]

Summary

Updated the garbage collector documentation to properly document the default 75% memory limit behavior in container environments:

• Updated the "Heap hard limit percent" section to clarify that in memory-constrained environments (containers), the container limit is considered the total physical memory, and the default value is 75%
• Updated the "Heap hard limit" section to reference the "Heap hard limit percent" section for the default value, instead of duplicating the 75% information

This centralizes the default percentage documentation in one place (GCHeapHardLimitPercent) and references it from the GCHeapHardLimit section, avoiding potential confusion about how the values interact.

Original prompt

This line

If this limit isn't configured but the process is running in a memory-constrained environment, that is, inside a container with a specified memory limit, a default value is set. That default is the greater of 20 MB or 75% of the memory limit on the container.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

---

Internal previews

📄 File	🔗 Preview link
docs/core/runtime-config/garbage-collector.md	docs/core/runtime-config/garbage-collector

[agocke]

@copilot I believe this would read better as:
Specifies the heap hard limit as a percentage of the total physical memory. If the process is running in a memory-constrained environment, that is, inside a container with a specified memory limit, the total physical memory is the memory limit; otherwise it's what's available on the machine.

[agocke]

@copilot I believe this would read better as:
Specifies the heap hard limit as a percentage of the total physical memory. If the process is running in a memory-constrained environment, that is, inside a container with a specified memory limit, the container limit is considered the total physical memory. If in a memory-constrained environment, the default value is 75%.

[Copilot]

@copilot I believe this would read better as:
Specifies the heap hard limit as a percentage of the total physical memory. If the process is running in a memory-constrained environment, that is, inside...

Updated the wording as suggested in commit f552eb5.

[agocke]

@copilot please address

[agocke]

I'm actually not sure this is correct. If this were true, then setting GCHeapHardLimitPercent to, say, 90% inside of a container would be equal to .75 * .9 * x = .675x, but it's actually .9x. I think we should instead note that inside a container the GCHeaphardLimitPercent has a different default value (and point to that section)

[Copilot]

Updated line 303 to reference the heap hard limit percent section instead of duplicating the 75% value. This centralizes the default value documentation in GCHeapHardLimitPercent and clarifies the relationship. Commit d6dd0eb.

[Copilot]

@copilot please address

Addressed in commit d6dd0eb. Updated the GCHeapHardLimit section to reference the GCHeapHardLimitPercent section for the default value, rather than duplicating the 75% information.