Fix chaos example issue and enrich notes & diagram

[caigen]

Pull Request

The issue or feature being addressed

Resolves #2483.

Details on the issue fix or feature implementation

Confirm the following

• I started this PR by branching from the head of the default branch
• I have targeted the PR to merge into the default branch
• I have included unit tests for the issue/feature N/A
• I have successfully run a local build N/A

[caigen]

@martincostello @martintmk please help to review. :)

[martincostello]

Thanks.

[martincostello]

Not sure why CI isn't starting - will close and re-open to see if that kicks it.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 85.36%. Comparing base (b60cf1d) to head (35dca07).
Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #2482   +/-   ##
=======================================
  Coverage   85.36%   85.36%           
=======================================
  Files         312      312           
  Lines        7466     7466           
  Branches     1121     1121           
=======================================
  Hits         6373     6373           
  Misses        908      908           
  Partials      185      185           

Flag	Coverage Δ
linux	85.36% <ø> (ø)
macos	85.36% <ø> (ø)
windows	85.32% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.