document details of algorithm
Merge branches 'dev' and 'master'