diff --git a/analysis_options.yaml b/analysis_options.yaml
index 6cf021a7e6..e3b1d6f957 100644
--- a/analysis_options.yaml
+++ b/analysis_options.yaml
@@ -145,7 +145,7 @@ linter:
     # - one_member_abstracts # too many false positives
     - only_throw_errors # this does get disabled in a few places where we have legacy code that uses strings et al
     - overridden_fields
-    - package_api_docs
+    # - package_api_docs # Deprecated (https://github.com/dart-lang/linter/issues/5107)
     - package_names
     - package_prefixed_library_names
     # - parameter_assignments # we do this commonly