gendocs: add note regarding refactoring