DOCSP-15819: troubleshooting overview (#189)

* DOCSP-15819: troubleshooting landing page

Author: Chris Cho

snooty.toml

@@ -1,7 +1,7 @@
 name = "kafka-connector"
 title = "MongoDB Kafka Connector"
 intersphinx = ["https://docs.mongodb.com/manual/objects.inv"]
-toc_landing_pages = ["/sink-connector", "/source-connector", "/sink-connector/configuration-properties", "/source-connector/configuration-properties", "/security-and-authentication"]
+toc_landing_pages = ["/sink-connector", "/source-connector", "/sink-connector/configuration-properties", "/source-connector/configuration-properties", "/security-and-authentication", "/troubleshooting"]
 
 [constants]
 mkc = "MongoDB Kafka Connector"

source/source-connector/fundamentals/change-streams.txt

@@ -105,7 +105,7 @@ Resume Tokens
 Your connector uses a **resume token** as its **offset**. An offset is a value
 your connector stores in an {+ak+} topic to keep track of what source data it
 has processed. Your connector uses its offset value when it must recover from
-a restart or crash. A resume token is a piece of data that references the 
+a restart or crash. A resume token is a piece of data that references the
 ``_id`` field of a change event document in your MongoDB oplog.
 
 If your source connector does not have an offset, such as when you start
@@ -116,8 +116,8 @@ its offset.
 
 If the resume token value of your source connector's offset does not correspond to
 any entry in your MongoDB deployment's oplog, your connector has an invalid resume
-token. To learn how to recover from an invalid resume token,
-:ref:`see our troubleshooting guide <kafka-troubleshoot-recover-invalid-resume-token>`.
+token. To learn how to recover from an invalid resume token, see the
+:ref:`invalid token troubleshooting guide <kafka-troubleshoot-invalid-resume-token>`.
 
 To learn more about resume tokens, see the following resources:
 

source/troubleshooting.txt

@@ -5,5 +5,10 @@ Troubleshooting
 .. toctree::
     :titlesonly:
     :maxdepth: 1
- 
+
     Invalid Resume Token </troubleshooting/recover-from-invalid-resume-token.txt>
+
+Learn how to address issues you may encounter while running the {+mkc+}.
+
+- :ref:`<kafka-troubleshoot-invalid-resume-token>`
+

source/troubleshooting/recover-from-invalid-resume-token.txt

@@ -13,8 +13,6 @@ Invalid Resume Token
    :class: singlecol
 
 
-.. _kafka-troubleshoot-recover-invalid-resume-token:
-
 Overview
 --------