Added API references to mkdocs, added build script

Author: SiyaoIsHiding

build-doc.sh

@@ -0,0 +1,18 @@
+# #Set up python environment
+#pyenv local 3.10.1
+#pip install mkdocs mkdocs-material pip install mkdocs-awesome-pages-plugin
+
+# Build Javadoc
+# Potentially need to `mvn clean install -DskipTests` first
+mvn javadoc:javadoc -pl core,query-builder,mapper-runtime
+mvn javadoc:aggregate
+
+# Copy Javadoc to manual directory
+mkdir manual/api || true
+cp -r target/site/apidocs/*  manual/api
+
+# Build manual with API references
+mkdocs build # or `mkdocs serve` to preview
+
+# Remove Javadoc from manual directory
+rm -rf manual/api

mkdocs.yml

@@ -1,6 +1,6 @@
 site_name: Java Driver for Apache Cassandra
 site_description: Java Driver for Apache Cassandra® Documentation
-site_url: https://github.com/apache/cassandra-java-driver/manual/
+site_url: https://github.com/apache/cassandra-java-driver
 repo_url: https://github.com/apache/cassandra-java-driver
 repo_name: apache/cassandra-java-driver
 
@@ -100,6 +100,7 @@ nav:
       - Request Execution: developer/request_execution/README.md
       - Admin: developer/admin/README.md
     - OSGi: osgi/README.md
+  - API References: api/index.html
   - FAQ: faq-README.md
   - Changelog: changelog-README.md
   - Upgrade Guide: upgrade-README.md