You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@kafka.apache.org by mj...@apache.org on 2022/12/28 21:13:19 UTC
[kafka] branch 3.4 updated: KAFKA-13881: Add Clients package description javadocs (#12895)
This is an automated email from the ASF dual-hosted git repository.
mjsax pushed a commit to branch 3.4
in repository https://gitbox.apache.org/repos/asf/kafka.git
The following commit(s) were added to refs/heads/3.4 by this push:
new 321de47e1f3 KAFKA-13881: Add Clients package description javadocs (#12895)
321de47e1f3 is described below
commit 321de47e1f3b92203045dd877ee9d4b596eb0d8a
Author: Greg Harris <gr...@aiven.io>
AuthorDate: Thu Dec 15 01:03:44 2022 -0800
KAFKA-13881: Add Clients package description javadocs (#12895)
Reviewers: Mickael Maison <mi...@gmail.com>
, Tom Bentley <tb...@redhat.com>
---
.../apache/kafka/clients/admin/package-info.java | 20 ++++++++++++++++++++
.../apache/kafka/clients/consumer/package-info.java | 20 ++++++++++++++++++++
.../apache/kafka/clients/producer/package-info.java | 20 ++++++++++++++++++++
.../org/apache/kafka/common/acl/package-info.java | 20 ++++++++++++++++++++
.../kafka/common/annotation/package-info.java | 20 ++++++++++++++++++++
.../org/apache/kafka/common/cache/package-info.java | 21 +++++++++++++++++++++
.../apache/kafka/common/compress/package-info.java | 21 +++++++++++++++++++++
.../apache/kafka/common/config/package-info.java | 20 ++++++++++++++++++++
.../kafka/common/config/provider/package-info.java | 20 ++++++++++++++++++++
.../kafka/common/config/types/package-info.java | 21 +++++++++++++++++++++
.../apache/kafka/common/errors/package-info.java | 20 ++++++++++++++++++++
.../apache/kafka/common/feature/package-info.java | 21 +++++++++++++++++++++
.../apache/kafka/common/header/package-info.java | 20 ++++++++++++++++++++
.../apache/kafka/common/memory/package-info.java | 21 +++++++++++++++++++++
.../apache/kafka/common/metrics/package-info.java | 20 ++++++++++++++++++++
.../kafka/common/metrics/stats/package-info.java | 20 ++++++++++++++++++++
.../apache/kafka/common/network/package-info.java | 21 +++++++++++++++++++++
.../java/org/apache/kafka/common/package-info.java | 20 ++++++++++++++++++++
.../apache/kafka/common/protocol/package-info.java | 21 +++++++++++++++++++++
.../kafka/common/protocol/types/package-info.java | 21 +++++++++++++++++++++
.../org/apache/kafka/common/quota/package-info.java | 20 ++++++++++++++++++++
.../apache/kafka/common/record/package-info.java | 21 +++++++++++++++++++++
.../apache/kafka/common/replica/package-info.java | 21 +++++++++++++++++++++
.../apache/kafka/common/requests/package-info.java | 21 +++++++++++++++++++++
.../apache/kafka/common/resource/package-info.java | 20 ++++++++++++++++++++
.../kafka/common/security/auth/package-info.java | 20 ++++++++++++++++++++
.../common/security/authenticator/package-info.java | 21 +++++++++++++++++++++
.../common/security/kerberos/package-info.java | 21 +++++++++++++++++++++
.../common/security/oauthbearer/package-info.java | 20 ++++++++++++++++++++
.../security/oauthbearer/secured/package-info.java | 21 +++++++++++++++++++++
.../apache/kafka/common/security/package-info.java | 20 ++++++++++++++++++++
.../kafka/common/security/plain/package-info.java | 20 ++++++++++++++++++++
.../kafka/common/security/scram/package-info.java | 20 ++++++++++++++++++++
.../kafka/common/security/ssl/package-info.java | 21 +++++++++++++++++++++
.../security/token/delegation/package-info.java | 20 ++++++++++++++++++++
.../kafka/common/serialization/package-info.java | 20 ++++++++++++++++++++
.../org/apache/kafka/common/utils/package-info.java | 21 +++++++++++++++++++++
.../kafka/server/authorizer/package-info.java | 20 ++++++++++++++++++++
.../apache/kafka/server/policy/package-info.java | 20 ++++++++++++++++++++
.../org/apache/kafka/server/quota/package-info.java | 20 ++++++++++++++++++++
40 files changed, 816 insertions(+)
diff --git a/clients/src/main/java/org/apache/kafka/clients/admin/package-info.java b/clients/src/main/java/org/apache/kafka/clients/admin/package-info.java
new file mode 100644
index 00000000000..20772f536f1
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/clients/admin/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides a Kafka client for performing administrative operations (such as creating topics and configuring brokers) on a Kafka cluster.
+ */
+package org.apache.kafka.clients.admin;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/package-info.java b/clients/src/main/java/org/apache/kafka/clients/consumer/package-info.java
new file mode 100644
index 00000000000..3a6ecbb99e6
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides a Kafka client for consuming records from topics and/or partitions in a Kafka cluster.
+ */
+package org.apache.kafka.clients.consumer;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/clients/producer/package-info.java b/clients/src/main/java/org/apache/kafka/clients/producer/package-info.java
new file mode 100644
index 00000000000..7db08066dde
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/clients/producer/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides a Kafka client for producing records to topics and/or partitions in a Kafka cluster.
+ */
+package org.apache.kafka.clients.producer;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/acl/package-info.java b/clients/src/main/java/org/apache/kafka/common/acl/package-info.java
new file mode 100644
index 00000000000..18fddb6c502
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/acl/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides classes representing Access Control Lists for authorization of clients
+ */
+package org.apache.kafka.common.acl;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/annotation/package-info.java b/clients/src/main/java/org/apache/kafka/common/annotation/package-info.java
new file mode 100644
index 00000000000..7aa05c14c5b
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/annotation/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides annotations used on Kafka APIs.
+ */
+package org.apache.kafka.common.annotation;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/cache/package-info.java b/clients/src/main/java/org/apache/kafka/common/cache/package-info.java
new file mode 100644
index 00000000000..37179c59e7d
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/cache/package-info.java
@@ -0,0 +1,21 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides reusable implementations of cache primitives.
+ * <strong>This package is not a supported Kafka API; the implementation may change without warning between minor or patch releases.</strong>
+ */
+package org.apache.kafka.common.cache;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/compress/package-info.java b/clients/src/main/java/org/apache/kafka/common/compress/package-info.java
new file mode 100644
index 00000000000..7c6b09816f2
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/compress/package-info.java
@@ -0,0 +1,21 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides mechanisms for compressing data handled by Kafka.
+ * <strong>This package is not a supported Kafka API; the implementation may change without warning between minor or patch releases.</strong>
+ */
+package org.apache.kafka.common.compress;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/config/package-info.java b/clients/src/main/java/org/apache/kafka/common/config/package-info.java
new file mode 100644
index 00000000000..47018f48253
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/config/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides common mechanisms for defining, parsing, validating, and documenting user-configurable parameters.
+ */
+package org.apache.kafka.common.config;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/config/provider/package-info.java b/clients/src/main/java/org/apache/kafka/common/config/provider/package-info.java
new file mode 100644
index 00000000000..cc4e1b9c17d
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/config/provider/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides a pluggable interface and some implementations for late-binding in configuration values.
+ */
+package org.apache.kafka.common.config.provider;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/config/types/package-info.java b/clients/src/main/java/org/apache/kafka/common/config/types/package-info.java
new file mode 100644
index 00000000000..f385b48bacb
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/config/types/package-info.java
@@ -0,0 +1,21 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides custom non-primitive types of configuration properties.
+ * <strong>This package is not a supported Kafka API; the implementation may change without warning between minor or patch releases.</strong>
+ */
+package org.apache.kafka.common.config.types;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/errors/package-info.java b/clients/src/main/java/org/apache/kafka/common/errors/package-info.java
new file mode 100644
index 00000000000..80532f78d66
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/errors/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides common exception classes.
+ */
+package org.apache.kafka.common.errors;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/feature/package-info.java b/clients/src/main/java/org/apache/kafka/common/feature/package-info.java
new file mode 100644
index 00000000000..151a73abe49
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/feature/package-info.java
@@ -0,0 +1,21 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides classes for programmatically communicating support for logical features.
+ * <strong>This package is not a supported Kafka API; the implementation may change without warning between minor or patch releases.</strong>
+ */
+package org.apache.kafka.common.feature;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/header/package-info.java b/clients/src/main/java/org/apache/kafka/common/header/package-info.java
new file mode 100644
index 00000000000..8ab332fbc35
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/header/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides API for application-defined metadata attached to Kafka records.
+ */
+package org.apache.kafka.common.header;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/memory/package-info.java b/clients/src/main/java/org/apache/kafka/common/memory/package-info.java
new file mode 100644
index 00000000000..6dc28debe1f
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/memory/package-info.java
@@ -0,0 +1,21 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides mechanisms for explicitly managing memory used by an application.
+ * <strong>This package is not a supported Kafka API; the implementation may change without warning between minor or patch releases.</strong>
+ */
+package org.apache.kafka.common.memory;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/metrics/package-info.java b/clients/src/main/java/org/apache/kafka/common/metrics/package-info.java
new file mode 100644
index 00000000000..64bb3ab5c80
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/metrics/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides the API used by Kafka clients to emit metrics which are then exposed using the * {@link org.apache.kafka.common.metrics.MetricsReporter} interface.
+ */
+package org.apache.kafka.common.metrics;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/metrics/stats/package-info.java b/clients/src/main/java/org/apache/kafka/common/metrics/stats/package-info.java
new file mode 100644
index 00000000000..05369d5b474
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/metrics/stats/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides methods of statistically aggregating metrics upon emission.
+ */
+package org.apache.kafka.common.metrics.stats;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/network/package-info.java b/clients/src/main/java/org/apache/kafka/common/network/package-info.java
new file mode 100644
index 00000000000..b090ca3e039
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/network/package-info.java
@@ -0,0 +1,21 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides the network API used by the Kafka clients
+ * <strong>This package is not a supported Kafka API; the implementation may change without warning between minor or patch releases.</strong>
+ */
+package org.apache.kafka.common.network;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/package-info.java b/clients/src/main/java/org/apache/kafka/common/package-info.java
new file mode 100644
index 00000000000..42b44fcd4fa
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides shared functionality for Kafka clients and servers.
+ */
+package org.apache.kafka.common;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/protocol/package-info.java b/clients/src/main/java/org/apache/kafka/common/protocol/package-info.java
new file mode 100644
index 00000000000..252e9ce8f53
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/protocol/package-info.java
@@ -0,0 +1,21 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides a common implementation of the Kafka Wire Protocol.
+ * <strong>This package is not a supported Kafka API; the implementation may change without warning between minor or patch releases.</strong>
+ */
+package org.apache.kafka.common.protocol;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/protocol/types/package-info.java b/clients/src/main/java/org/apache/kafka/common/protocol/types/package-info.java
new file mode 100644
index 00000000000..43d820ac437
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/protocol/types/package-info.java
@@ -0,0 +1,21 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides types of data which can be serialized in the Kafka Wire Protocol.
+ * <strong>This package is not a supported Kafka API; the implementation may change without warning between minor or patch releases.</strong>
+ */
+package org.apache.kafka.common.protocol.types;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/quota/package-info.java b/clients/src/main/java/org/apache/kafka/common/quota/package-info.java
new file mode 100644
index 00000000000..34a4bd08eb1
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/quota/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides mechanisms for enforcing resource quotas.
+ */
+package org.apache.kafka.common.quota;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/record/package-info.java b/clients/src/main/java/org/apache/kafka/common/record/package-info.java
new file mode 100644
index 00000000000..4a5db11149e
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/record/package-info.java
@@ -0,0 +1,21 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides the low-level representation of records and record batches used by clients and servers.
+ * <strong>This package is not a supported Kafka API; the implementation may change without warning between minor or patch releases.</strong>
+ */
+package org.apache.kafka.common.record;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/replica/package-info.java b/clients/src/main/java/org/apache/kafka/common/replica/package-info.java
new file mode 100644
index 00000000000..83fe1ba359f
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/replica/package-info.java
@@ -0,0 +1,21 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides mechanism for determining placement of Kafka log replicas.
+ * <strong>This package is not a supported Kafka API; the implementation may change without warning between minor or patch releases.</strong>
+ */
+package org.apache.kafka.common.replica;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/requests/package-info.java b/clients/src/main/java/org/apache/kafka/common/requests/package-info.java
new file mode 100644
index 00000000000..1a0cc8937a8
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/requests/package-info.java
@@ -0,0 +1,21 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provide Request and Response class representations for RPCs executed via the Kafka Protocol.
+ * <strong>This package is not a supported Kafka API; the implementation may change without warning between minor or patch releases.</strong>
+ */
+package org.apache.kafka.common.requests;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/resource/package-info.java b/clients/src/main/java/org/apache/kafka/common/resource/package-info.java
new file mode 100644
index 00000000000..5d896179e3c
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/resource/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides client handles representing logical resources in a Kafka cluster.
+ */
+package org.apache.kafka.common.resource;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/security/auth/package-info.java b/clients/src/main/java/org/apache/kafka/common/security/auth/package-info.java
new file mode 100644
index 00000000000..b2d84125e70
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/security/auth/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides pluggable interfaces for implementing Kafka authentication mechanisms.
+ */
+package org.apache.kafka.common.security.auth;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/security/authenticator/package-info.java b/clients/src/main/java/org/apache/kafka/common/security/authenticator/package-info.java
new file mode 100644
index 00000000000..8b7f77b344e
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/security/authenticator/package-info.java
@@ -0,0 +1,21 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides some authentication mechanisms for securing Kafka clusters.
+ * <strong>This package is not a supported Kafka API; the implementation may change without warning between minor or patch releases.</strong>
+ */
+package org.apache.kafka.common.security.authenticator;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/security/kerberos/package-info.java b/clients/src/main/java/org/apache/kafka/common/security/kerberos/package-info.java
new file mode 100644
index 00000000000..5a2f5bc9db3
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/security/kerberos/package-info.java
@@ -0,0 +1,21 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides adaptor for using Kerberos for securing Kafka clusters.
+ * <strong>This package is not a supported Kafka API; the implementation may change without warning between minor or patch releases.</strong>
+ */
+package org.apache.kafka.common.security.kerberos;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/security/oauthbearer/package-info.java b/clients/src/main/java/org/apache/kafka/common/security/oauthbearer/package-info.java
new file mode 100644
index 00000000000..b1d5f2d6e3d
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/security/oauthbearer/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides a {@link javax.security.auth.spi.LoginModule} for using OAuth Bearer Token authentication with Kafka clusters.
+ */
+package org.apache.kafka.common.security.oauthbearer;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/security/oauthbearer/secured/package-info.java b/clients/src/main/java/org/apache/kafka/common/security/oauthbearer/secured/package-info.java
new file mode 100644
index 00000000000..4edb7dba789
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/security/oauthbearer/secured/package-info.java
@@ -0,0 +1,21 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * This package is deprecated.
+ * @deprecated See {@link org.apache.kafka.common.security.oauthbearer}
+ */
+package org.apache.kafka.common.security.oauthbearer.secured;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/security/package-info.java b/clients/src/main/java/org/apache/kafka/common/security/package-info.java
new file mode 100644
index 00000000000..c1357d93b62
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/security/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides mechanisms for securing a Kafka cluster and authenticating Kafka clients.
+ */
+package org.apache.kafka.common.security;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/security/plain/package-info.java b/clients/src/main/java/org/apache/kafka/common/security/plain/package-info.java
new file mode 100644
index 00000000000..3b9fed7c44c
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/security/plain/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides implementation to use plaintext credentials authentication for securing Kafka clusters.
+ */
+package org.apache.kafka.common.security.plain;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/security/scram/package-info.java b/clients/src/main/java/org/apache/kafka/common/security/scram/package-info.java
new file mode 100644
index 00000000000..d06b92d3f6b
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/security/scram/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides adaptor to use the Salted Challenge Response Authentication Mechanism for securing Kafka clusters.
+ */
+package org.apache.kafka.common.security.scram;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/security/ssl/package-info.java b/clients/src/main/java/org/apache/kafka/common/security/ssl/package-info.java
new file mode 100644
index 00000000000..0a40b975990
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/security/ssl/package-info.java
@@ -0,0 +1,21 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides utilities for using SSL encryption for networked connections.
+ * <strong>This package is not a supported Kafka API; the implementation may change without warning between minor or patch releases.</strong>
+ */
+package org.apache.kafka.common.security.ssl;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/security/token/delegation/package-info.java b/clients/src/main/java/org/apache/kafka/common/security/token/delegation/package-info.java
new file mode 100644
index 00000000000..3ee197eff3f
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/security/token/delegation/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides mechanism for delegating authorization to a distinct Principal for securing Kafka clusters.
+ */
+package org.apache.kafka.common.security.token.delegation;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/serialization/package-info.java b/clients/src/main/java/org/apache/kafka/common/serialization/package-info.java
new file mode 100644
index 00000000000..8b601960900
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/serialization/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides interface and some implementations of serialization/deserialization routines for various objects.
+ */
+package org.apache.kafka.common.serialization;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/common/utils/package-info.java b/clients/src/main/java/org/apache/kafka/common/utils/package-info.java
new file mode 100644
index 00000000000..36479d3402a
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/common/utils/package-info.java
@@ -0,0 +1,21 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides common utilities for Kafka server and clients.
+ * <strong>This package is not a supported Kafka API; the implementation may change without warning between minor or patch releases.</strong>
+ */
+package org.apache.kafka.common.utils;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/server/authorizer/package-info.java b/clients/src/main/java/org/apache/kafka/server/authorizer/package-info.java
new file mode 100644
index 00000000000..733268e9da0
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/server/authorizer/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides pluggable interface for performing authorization on a Kafka server.
+ */
+package org.apache.kafka.server.authorizer;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/server/policy/package-info.java b/clients/src/main/java/org/apache/kafka/server/policy/package-info.java
new file mode 100644
index 00000000000..a79d4479e90
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/server/policy/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides pluggable interfaces for expressing policies on topics and configs.
+ */
+package org.apache.kafka.server.policy;
\ No newline at end of file
diff --git a/clients/src/main/java/org/apache/kafka/server/quota/package-info.java b/clients/src/main/java/org/apache/kafka/server/quota/package-info.java
new file mode 100644
index 00000000000..a6b57f1364d
--- /dev/null
+++ b/clients/src/main/java/org/apache/kafka/server/quota/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Provides pluggable interface for enforcing client quotas from a Kafka server.
+ */
+package org.apache.kafka.server.quota;
\ No newline at end of file