doc: adjusted after review