This is an automated email from the ASF dual-hosted git repository.
lhotari pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/pulsar.git
The following commit(s) were added to refs/heads/master by this push:
new cec32df5778 [improve][doc] Add coding guideline for fully qualified
class names (#25928)
cec32df5778 is described below
commit cec32df5778cc94147e69bd22a3023be9612fb0f
Author: Ruimin MA <[email protected]>
AuthorDate: Fri Jun 5 16:51:37 2026 +0800
[improve][doc] Add coding guideline for fully qualified class names (#25928)
---
AGENTS.md | 2 ++
CODING.md | 2 ++
2 files changed, 4 insertions(+)
diff --git a/AGENTS.md b/AGENTS.md
index e6479cf7229..40aa15f98ae 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -56,6 +56,8 @@ A few rules matter specifically when an AI tool makes the
change, on top of the
these outward-facing actions — see *Licensing and provenance* above.
- **A clean local run is weak evidence for concurrency/data race fixes**
(timing- and
platform-dependent). See
[`CODING.md`](CODING.md#reproducing-concurrency--memory-visibility-bugs).
+- **Follow Java style guidance.** For Java conventions, including imports over
fully qualified class
+ names, follow [`CODING.md`](CODING.md#style).
## Critical rules
diff --git a/CODING.md b/CODING.md
index 6623e342e75..af05622f592 100644
--- a/CODING.md
+++ b/CODING.md
@@ -13,6 +13,8 @@ for the agent-specific guardrails on top of it.
- No `@author` tags in Javadoc.
- Every `TODO` must reference a GitHub issue, e.g. `// TODO:
https://github.com/apache/pulsar/issues/XXXX`.
- Checkstyle config: `buildtools/src/main/resources/pulsar/checkstyle.xml`.
Lombok is enabled.
+- Prefer imports over fully qualified class names in code. Use a fully
qualified class name only when
+ needed to disambiguate a name collision that imports cannot resolve.
## Logging
