Improve Flowchart and correct description of SecondPeriod re #9047

Signed-off-by: Karl Palmen <karl.palmen@stfc.ac.uk>
Merge branch 'feature/9047_example_flowchart_wiki' into develop