Merged
Conversation
The tutorial previously scattered runtime information across gotchas and appendices without a cohesive chapter. This adds a dedicated chapter covering the scheduler, program lifecycle, garbage collection (both intra-actor and ORCA), ASIO, backpressure, and runtime options. The two superseded appendix pages (Memory Allocation at Runtime and Garbage Collection with Pony-ORCA) are removed, with their content folded into the new GC page and redirects added in netlify.toml. Cross-references are added from the scheduling and GC gotcha pages, and the compiler-args appendix now points to the new Runtime Options page. Adapted in part from rhagenson's earlier work on the runtime-basics branch. Closes #408
✅ Deploy Preview for pony-tutorial ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
jemc
approved these changes
Mar 4, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a new chapter covering Pony runtime internals, placed between C-FFI and Gotchas in the nav. The chapter has six pages:
--pony*command-line flags plus@runtime_override_defaultsThe two appendix pages (Memory Allocation at Runtime and Garbage Collection with Pony-ORCA) are superseded by the new GC page and removed, with 301 redirects added in netlify.toml. Cross-references are added from the scheduling and GC gotcha pages, and the compiler-args appendix now points to the new Runtime Options page.
Adapted in part from rhagenson's earlier work on the runtime-basics branch.
Closes #408