More comprehensive documentation

huggingface · Oct 11, 2023 · 6a60643 · 6a60643
1 parent e479035
commit 6a60643
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/docs/source/en/main_classes/logging.md b/docs/source/en/main_classes/logging.md
@@ -80,6 +80,10 @@ that has already been deprecated and `DeprecationWarning` to indicate an upcomin
 We use both in the `transformers` library. We leverage and adapt `logging`'s `captureWarning` method to allow
 management of these warning messages by the verbosity setters above.
 
+What does that mean for developers of the library? We should respect the following heuristic:
+- `warnings` should be favored for developers of the library and libraries dependent on `transformers`
+- `logging` should be used for end-users of the library using it in every-day projects
+
 See reference of the `captureWarnings` method below.
 
 [[autodoc]] logging.captureWarnings