update docs re: alg