docs, second pass