[maintenance] documentation + simplifications