doc: refactorings