Platform: Confluence source connector (#341)

Author: Paul-Cornell

mint.json

@@ -451,6 +451,7 @@
               "pages": [
                 "platform/sources/overview",
                 "platform/sources/azure-blob-storage",
+                "platform/sources/confluence",
                 "platform/sources/databricks-volumes",
                 "platform/sources/google-cloud",
                 "platform/sources/mongodb",

platform/connectors.mdx

@@ -12,6 +12,7 @@ The Unstructured Platform supports connecting to the following source and destin
 ## Sources
 
 - [Azure](/platform/sources/azure-blob-storage)
+- [Confluence](/platform/sources/confluence)
 - [Databricks Volumes](/platform/sources/databricks-volumes)
 - [Google Cloud Storage](/platform/sources/google-cloud)
 - [MongoDB](/platform/sources/mongodb)

platform/sources/confluence.mdx

@@ -0,0 +1,26 @@
+---
+title: Confluence
+---
+
+Ingest your files into Unstructured from Confluence.
+
+You'll need:
+
+import ConfluencePrerequisites from '/snippets/general-shared-text/confluence.mdx';
+
+<ConfluencePrerequisites />
+
+To create the source connector:
+
+1. On the sidebar, click **Connectors**.
+2. Click **Sources**.
+3. Click **Add new**.
+4. Give the connector some unique **Name**.
+5. In the **Provider** area, click **Confluence**.
+6. Click **Continue**. 
+7. Follow the on-screen instructions to fill in the fields as described later on this page.
+8. Click **Save and Test**.
+
+import ConfluenceFields from '/snippets/general-shared-text/confluence-platform.mdx';
+
+<ConfluenceFields />

platform/sources/overview.mdx

@@ -19,6 +19,7 @@ To create a source connector:
 7. Fill in the fields according to your connector type. To learn how, click your connector type in the following list:
 
    - [Azure](/platform/sources/azure-blob-storage)
+   - [Confluence](/platform/sources/confluence)
    - [Databricks Volumes](/platform/sources/databricks-volumes)
    - [Google Cloud Storage](/platform/sources/google-cloud)
    - [MongoDB](/platform/sources/mongodb)

snippets/general-shared-text/confluence-platform.mdx

@@ -0,0 +1,13 @@
+Fill in the following fields:
+
+- **Name** (_required_): A unique name for this connector.
+- **URL** (_required_): The URL to the target Confluence Cloud instance.
+- **User Email** (_required_): The email address of the user who has access to the instance.
+- **API Token** (_required_): The Confluence API token that provides access to the instance.
+- **Max Number of Spaces**: The maximum number of Confluence spaces to access within the Confluence Cloud instance. 
+  The default is 500 unless otherwise specified.
+- **Max Number of Docs Per Space**: The maximum number of documents to access within each space. 
+  The default is 150 unless otherwise specified.
+- **List of Spaces**: A comma-separated string that lists the names of all of the spaces to access, for example: `luke,paul`. 
+  By default, if no space names are specified, and the **Max Number of Spaces** is reached for the instance, be aware that you might get 
+  unexpected results.