I could be convinced to drop the nix example. I think it's neat, and the language has a lot more useful features for this kind of thing, but it's admittedly weird to point to given how coupled it is with the nix package manager.

Codecov Report

Base: 67.78% // Head: 67.63% // Decreases project coverage by -0.15% ⚠️

Coverage data is based on head (bda02c3) compared to base (884f478).
Patch has no changes to coverable lines.

❗ Current head bda02c3 differs from pull request most recent head 545237e. Consider uploading reports for the commit 545237e to get more accurate results

@@            Coverage Diff             @@
##             main    #2605      +/-   ##
==========================================
- Coverage   67.78%   67.63%   -0.16%     
==========================================
  Files         198      198              
  Lines       29180    29192      +12     
  Branches     5739     5740       +1     
==========================================
- Hits        19781    19743      -38     
- Misses       4829     4885      +56     
+ Partials     4570     4564       -6     

☔ View full report at Codecov.
📢 Do you have feedback about the report comment? Let us know in this issue.

Oh! Just noticed that https://shadow.github.io/docs/guide/shadow_config_overview.html#yaml-extensions-experimental already talks about the yaml extensions and has examples.

I do kind of like having a separate page with single running example of the yaml extension + generating with other tools, though. Maybe it's fine to have both, or maybe it'd make sense to drop the examples from the overview page and have a forward reference to this page instead?