diff --git a/lucene/facet/src/java/org/apache/lucene/facet/associations/search/package.html b/lucene/facet/src/java/org/apache/lucene/facet/associations/search/package.html
new file mode 100644
index 00000000000..2925f070cba
--- /dev/null
+++ b/lucene/facet/src/java/org/apache/lucene/facet/associations/search/package.html
@@ -0,0 +1,26 @@
+<!--
+ 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.
+-->
+<html>
+<head>
+<title>Category Association</title>
+</head>
+<body>
+<h1>Category Association</h1>
+
+Associations search code
+</body>
+</html>
diff --git a/lucene/facet/src/java/org/apache/lucene/facet/partitions/search/package.html b/lucene/facet/src/java/org/apache/lucene/facet/partitions/search/package.html
new file mode 100644
index 00000000000..a4d8d6234e1
--- /dev/null
+++ b/lucene/facet/src/java/org/apache/lucene/facet/partitions/search/package.html
@@ -0,0 +1,27 @@
+<!--
+ 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.
+-->
+<html>
+<head>
+<title>Category Partitions</title>
+</head>
+<body>
+<h1>Category Partitions</h1>
+
+Allows partitioning the category ordinals space, so that less RAM is consumed during search.
+Only meaningful for very large taxonomies (tens of millions of categories).
+</body>
+</html>
