doc strings for the new API