clearer commitment to stable v1 in api docs