diff --git a/README.md b/README.md
index a0563ca3d7..6b2638a067 100644
--- a/README.md
+++ b/README.md
@@ -33,6 +33,7 @@ Please see the [USER_GUIDE](USER_GUIDE.md) for code snippets.
 
 * [Project Website](https://opensearch.org/)
 * [Documentation](https://opensearch.org/docs/latest/clients/java/)
+* [JavaDoc](https://www.javadoc.io/doc/org.opensearch.client/opensearch-java/latest/index.html)
 * [Maven Central](https://search.maven.org/artifact/org.opensearch.client/opensearch-java)
 * [Snapshot Builds](https://aws.oss.sonatype.org/content/repositories/snapshots/org/opensearch/client/opensearch-java/)
 * Need help? Try [Forums](https://discuss.opendistrocommunity.dev/)
diff --git a/USER_GUIDE.md b/USER_GUIDE.md
index 6e76aa90d8..c024320632 100644
--- a/USER_GUIDE.md
+++ b/USER_GUIDE.md
@@ -19,11 +19,11 @@
     - [Create a data stream](#create-a-data-stream)
     - [Get data stream](#get-data-stream)
     - [Data stream stats](#data-stream-stats)
-    - [Delete data stream](#delete-data-stream-and-backing-indices)
+    - [Delete data stream and backing indices](#delete-data-stream-and-backing-indices)
   - [Cat API](#cat-api)
     - [Cat Indices](#cat-indices)
-    - [Cat Aliases](#cat-aliases)
-    - [Cat Nodes](#cat-nodes)
+    - [Cat aliases](#cat-aliases)
+    - [Cat nodes](#cat-nodes)
 - [Using different transport options](#using-different-transport-options)
   - [Amazon Managed OpenSearch](#amazon-managed-opensearch)