Bf/corrstability: rudimentary fixes and tests for CorrStability found in the codebase

+ some docs tune ups in few other places