anuraaga · Oct 1, 2026 · Oct 5, 2026 · Oct 5, 2026 · ajeetdsouza · Oct 6, 2026
diff --git a/docs/writing-plugins/generating-files.md b/docs/writing-plugins/generating-files.md
@@ -224,6 +224,16 @@ It also emits `# ruff: noqa` to suppress linting on generated code, and
 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.
 
+If the generated code references deprecated members, pass
+`suppress_deprecated=True` to also emit directives that stop pyright and ty from
+reporting it:
+
+```python
+f.preamble(desc, suppress_deprecated=True)
+```
+
+Only pass it when needed, since ty reports the directive as unused otherwise.
+
 !!! note
     Every `.py` file also has `from __future__ import annotations` inserted
     automatically — with or without a preamble.
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/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