Add mention for legacy doc tools

karllessard · karllessard · commit 1ce80fb8eefb · 2025-12-12T15:10:25.000-05:00
diff --git a/docs/legacy/requirements.txt b/docs/legacy/requirements.txt
diff --git a/docs/legacy_tools/build_java_api_docs.py b/docs/legacy_tools/build_java_api_docs.py
@@ -13,6 +13,12 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 # ==============================================================================
+
+######################################################################################################################
+# IMPORTANT: Tools under this folder are not used anymore to generate the Java API docs, as there are unfixed issues
+#            with DocLava. We are keeping it here for reference, in case we want to revisit it in the future.
+######################################################################################################################
+
 """Generate TensorFlow Java reference docs for TensorFlow.org."""
 from __future__ import absolute_import
 from __future__ import division
diff --git a/docs/legacy_tools/requirements.txt b/docs/legacy_tools/requirements.txt
@@ -0,0 +1,7 @@
+######################################################################################################################
+# IMPORTANT: Tools under this folder are not used anymore to generate the Java API docs, as there are unfixed issues
+#            with DocLava. We are keeping it here for reference, in case we want to revisit it in the future.
+######################################################################################################################
+GitPython
+requests
+tensorflow-docs
diff --git a/docs/legacy_tools/run-javadoc-for-tf-local.sh b/docs/legacy_tools/run-javadoc-for-tf-local.sh
@@ -1,4 +1,10 @@
 #!/bin/bash
+
+######################################################################################################################
+# IMPORTANT: Tools under this folder are not used anymore to generate the Java API docs, as there are unfixed issues
+#            with DocLava. We are keeping it here for reference, in case we want to revisit it in the future.
+######################################################################################################################
+
 set -ex
 
 export JAVA_HOME=/Library/Java/JavaVirtualMachines/zulu-11.jdk/Contents/Home # Or change to any JDK 11 home path
