This repo contains build tools for the following driver documentation:
- Reactive Streams (legacy reference and API)
- Scala (legacy reference and API)
- Java Sync (legacy reference and current API)
The aforementioned documentation resides in the "gh-pages" branch of the MongoDB Java Driver.
For the current Java Sync driver reference documentation, see the Java Sync reference docs site or the source in the docs-java repository.
Now that Java RS and Scala documentation is built on Snooty, you do not have to update the legacy documentation site.
Always build the API docs for any new major and minor releases.
To build the API docs, navigate to your mongo-java-driver repo
(Note: NOT the submodule in this repo) and execute the appropriate gradlew command
after checking out the correct tag. Ensure you installed the Java
version specified in the :bson:compileJava task in your development
environment prior to building. In the most recent (5/2024) deploy, this
was Java 17.
For example, to build the API docs for the 4.4 release of the driver run the following commands:
git checkout r4.4.0
./gradlew clean docsYou need to create the <version>/apidocs directory yourself before
copying the generated API docs files.
Run the following commands to create the apidocs directory:
cd docs-java-other/mongo-java-driver
mkdir -p <version>/apidocsThen copy the build/docs folder into the apidocs directory. For example,
if the mongo-java-driver repo is on a sibling level with this repo, run the following command:
cp -a ../mongo-java-driver/build/docs/ ./mongo-java-driver/<version>/apidocsYour submodule directory should contain a directory structure that resembles the following:
<this repo>/<submodule directory>/<version>/apidocs/{bson,mongodb-driver-core,mongodb-driver-sync,mongodb-driver-legacy, mongodb-driver-reactivestreams/}To publish the documentation, run the following commands in your shell from the docs-java-other repository location:
cd mongo-java-driver
git add .
git commit -m <message>
git rebase -i --root
git push origin gh-pages -f