Revise documentation including usage example re #9997

It was also necessary to initialize a variable within the algorithm for the usage example to work correctly.

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