doc: second pass