This is a followup to this comment. I think you should not document calling actor.__ray_terminate__.remote() directly. I think Ray should provide ray.terminate_actor(actor) API, which then calls __ray_terminate__. This is more in-line with how Python has it. You do not call object.__delattr__(field) directly, you interact through API with it (del object[field]). The method exist to be able to be subclassed, but not called directly.