[maintenance] documentation + code cleanup