DOCSP-27843: API documentation link reformat (#154)

* DOCSP-27843: API documentation link reformat

Author: Chris Cho

snooty.toml

@@ -13,10 +13,6 @@ artifact-id-2-13 = "mongo-spark-connector_2.13"
 artifact-id-2-12 = "mongo-spark-connector_2.12"
 spark-core-version = "3.3.1"
 spark-sql-version = "3.3.1"
-scala-previous = "2.12"
-scala-previous-full = "2.12.13"
-scala-latest = "2.13"
-scala-latest-full = "2.13.10"
 
 [substitutions]
 copy = "unicode:: U+000A9"

source/api-docs.txt

@@ -0,0 +1,9 @@
+=================
+API Documentation
+=================
+
+.. toctree::
+   :titlesonly:
+
+   Spark Connector for Scala 2.13 <https://www.javadoc.io/doc/org.mongodb.spark/{+artifact-id-2-13+}/{+current-version+}/index.html>
+   Spark Connector for Scala 2.12 <https://www.javadoc.io/doc/org.mongodb.spark/{+artifact-id-2-12+}/{+current-version+}/index.html>

source/index.txt

@@ -54,4 +54,4 @@ versions of Apache Spark and MongoDB:
    structured-streaming
    faq
    release-notes
-   API Docs <https://www.javadoc.io/doc/org.mongodb.spark/mongo-spark-connector/latest/index.html>
+   api-docs

source/java/api.txt

@@ -5,40 +5,40 @@ Dependency Management
 
 .. include:: /includes/scala-java-dependencies.rst
 
-Beginning in version 3.2.0, Apache Spark supports both Scala {+scala-previous+} and {+scala-latest+}. 
-Spark 3.1.3 and previous versions support only Scala {+scala-previous+}. 
+Beginning in version 3.2.0, Apache Spark supports both Scala 2.12 and 2.13.
+Spark 3.1.3 and previous versions support only Scala 2.12.
 To provide support for both Scala versions, version {+current-version+} of the Spark 
 Connector produces two artifacts:
 
-- ``org.mongodb.spark:mongo-spark-connector_{+scala-previous+}:{+current-version+}`` is 
-  compiled against Scala {+scala-previous+}, and supports Spark 3.1.x and above.  
-- ``org.mongodb.spark:mongo-spark-connector_{+scala-latest+}:{+current-version+}`` is 
-  compiled against Scala {+scala-latest+}, and supports Spark 3.2.x and above.
+- ``org.mongodb.spark:{+artifact-id-2-12+}:{+current-version+}`` is 
+  compiled against Scala 2.12, and supports Spark 3.1.x and above.  
+- ``org.mongodb.spark:{+artifact-id-2-13+}:{+current-version+}`` is 
+  compiled against Scala 2.13, and supports Spark 3.2.x and above.
 
 .. important::
 
    Use the Spark Connector artifact that's compatible with your
    versions of Scala and Spark.  
 
 The following excerpt from a Maven ``pom.xml`` file shows how to include dependencies 
-compatible with Scala {+scala-previous+}:
+compatible with Scala 2.12:
 
 .. code-block:: xml
 
    <dependencies>
      <dependency>
        <groupId>org.mongodb.spark</groupId>
-       <artifactId>mongo-spark-connector_{+scala-previous+}</artifactId>
+       <artifactId>{+artifact-id-2-12+}</artifactId>
        <version>{+current-version+}</version>
      </dependency>
      <dependency>
        <groupId>org.apache.spark</groupId>
-       <artifactId>spark-core_{+scala-previous+}</artifactId>
+       <artifactId>spark-core_2.12</artifactId>
        <version>{+spark-core-version+}</version>
      </dependency>
      <dependency>
        <groupId>org.apache.spark</groupId>
-       <artifactId>spark-sql_{+scala-previous+}</artifactId>
+       <artifactId>spark-sql_2.12</artifactId>
        <version>{+spark-sql-version+}</version>
      </dependency>
    </dependencies>

source/scala/api.txt

@@ -40,9 +40,9 @@ a `SBT <http://www.scala-sbt.org/documentation.html>`_ ``build.scala`` file:
 
 .. code-block:: scala
 
-   scalaVersion := "{+scala-previous+}",
+   scalaVersion := "2.12",
    libraryDependencies ++= Seq(
-     "org.mongodb.spark" %% "mongo-spark-connector" % "{+current-version+}",
+     "org.mongodb.spark" %% "{+artifact-id-2-12+}" % "{+current-version+}",
      "org.apache.spark" %% "spark-core" % "{+spark-core-version+}",
      "org.apache.spark" %% "spark-sql" % "{+spark-sql-version+}"
    )