clarify application flow
more updates
s/initialisation/initialization
Merge branch 'doc-update'