Skip to content

Commit 9095b83

Browse files
authored
Add op graph rewrite requirement
1 parent 49ab633 commit 9095b83

File tree

1 file changed

+1
-0
lines changed

1 file changed

+1
-0
lines changed

rfcs/20230621-tf-api-deprecation.md

+1
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@ A TensorFlow API is considered fully deprecated when:
5858
* Runtime warnings can be added by wrapping a deprecated pattern with `@deprecation(...)` as defined in [deprecation.py](https://github.com/tensorflow/tensorflow/blob/master/tensorflow/python/util/deprecation.py), or, if of greater scale, by adding a distinct deprecated export wrapper in [tf_export.py](https://github.com/tensorflow/tensorflow/blob/master/tensorflow/python/util/tf_export.py) (and using said new wrapper).
5959
* **Internal usage of deprecated APIs should not raise warnings**. Any warnings should only come from a user-facing call of the deprecated API.
6060
* Ex: if `tf.bar` uses deprecated `tf.foo`, calling `tf.bar` should not trigger a warning.
61+
* If an op is being deprecated, it is functionally replaced through graph rewrites of other existing ops.
6162
* As appropriate, examples (e.g. experimental Colab notebooks) are created demonstrating the replacement of any deprecated modules or methods.
6263
* The API is covered by a publicly available _strict mode_ which users can optionally enable to convert warnings to failures, with error messages that guide them to replacements.
6364
* Strict mode is a globally applied state, switched on with `tf.experimental.enable_strict_mode()`.

0 commit comments

Comments
 (0)