anuraaga · Oct 1, 2026 · Oct 5, 2026 · Oct 5, 2026
diff --git a/docs/writing-plugins/generating-files.md b/docs/writing-plugins/generating-files.md
@@ -219,8 +219,9 @@ It emits a DO NOT EDIT header derived from the source file and plugin name:
 # Generated by protoc-gen-hello v0.1.0 with parameter "".
 ```
 
-It also emits `# ruff: noqa` to suppress linting on generated code, and
-`# fmt: off` to prevent formatters from modifying it.
+It also emits `# ruff: noqa` to suppress linting on generated code,
+directives that stop pyright and ty from reporting its use of deprecated
+symbols, and `# fmt: off` to prevent formatters from modifying it.
 Use the `no_fmt_off` option (see [Options](./options.md#no_fmt_off)) to omit
 `# fmt: off` if you want ruff to format the output.
 

diff --git a/docs/writing-plugins/index.md b/docs/writing-plugins/index.md
@@ -65,6 +65,9 @@ src/gen/
 # Generated by protoc-gen-hello v0.1.0 with parameter "".
 # ruff: noqa: PGH004
 # ruff: noqa
+# pyright: reportDeprecated=false
+# ty: ignore[unused-ignore-comment]
+# ty: ignore[deprecated, unused-ignore-comment]
 # fmt: off
 
 from __future__ import annotations
@@ -151,6 +154,9 @@ For `user/v1/user.proto` this produces `src/gen/user/v1/user_rpc.py`:
 # Generated by protoc-gen-rpc v0.1.0 with parameter "".
 # ruff: noqa: PGH004
 # ruff: noqa
+# pyright: reportDeprecated=false
+# ty: ignore[unused-ignore-comment]
+# ty: ignore[deprecated, unused-ignore-comment]
 # fmt: off
 
 from __future__ import annotations

diff --git a/examples/plugin/tests/gen/user/v1/user_pb.py b/examples/plugin/tests/gen/user/v1/user_pb.py
diff --git a/examples/plugin/tests/gen/user/v1/user_rpc.py b/examples/plugin/tests/gen/user/v1/user_rpc.py
diff --git a/examples/protobuf/src/example/gen/example_pb.py b/examples/protobuf/src/example/gen/example_pb.py
diff --git a/packages/bench/src/bench/gen/buffa/bench_messages_pb.py b/packages/bench/src/bench/gen/buffa/bench_messages_pb.py
diff --git a/packages/bench/src/bench/gen/buffa/benchmark_message1_proto3_pb.py b/packages/bench/src/bench/gen/buffa/benchmark_message1_proto3_pb.py
diff --git a/packages/bench/src/bench/gen/buffa/benchmarks_pb.py b/packages/bench/src/bench/gen/buffa/benchmarks_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message0_pb.py b/packages/bench/src/bench/gen/fleetbench/Message0_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message10_pb.py b/packages/bench/src/bench/gen/fleetbench/Message10_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message11_pb.py b/packages/bench/src/bench/gen/fleetbench/Message11_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message12_pb.py b/packages/bench/src/bench/gen/fleetbench/Message12_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message13_pb.py b/packages/bench/src/bench/gen/fleetbench/Message13_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message14_pb.py b/packages/bench/src/bench/gen/fleetbench/Message14_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message15_pb.py b/packages/bench/src/bench/gen/fleetbench/Message15_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message16_pb.py b/packages/bench/src/bench/gen/fleetbench/Message16_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message17_pb.py b/packages/bench/src/bench/gen/fleetbench/Message17_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message18_pb.py b/packages/bench/src/bench/gen/fleetbench/Message18_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message19_pb.py b/packages/bench/src/bench/gen/fleetbench/Message19_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message1_pb.py b/packages/bench/src/bench/gen/fleetbench/Message1_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message2_pb.py b/packages/bench/src/bench/gen/fleetbench/Message2_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message3_pb.py b/packages/bench/src/bench/gen/fleetbench/Message3_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message4_pb.py b/packages/bench/src/bench/gen/fleetbench/Message4_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message5_pb.py b/packages/bench/src/bench/gen/fleetbench/Message5_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message6_pb.py b/packages/bench/src/bench/gen/fleetbench/Message6_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message7_pb.py b/packages/bench/src/bench/gen/fleetbench/Message7_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message8_pb.py b/packages/bench/src/bench/gen/fleetbench/Message8_pb.py
diff --git a/packages/bench/src/bench/gen/fleetbench/Message9_pb.py b/packages/bench/src/bench/gen/fleetbench/Message9_pb.py
diff --git a/packages/bench/src/bench/gen/home/home_pb.py b/packages/bench/src/bench/gen/home/home_pb.py