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.