add a @return description (particularly mention why false is actually success)