Move database connection info to getting-started

kmcginnes · kmcginnes · commit 20f197c665ae · 2025-09-11T11:06:56.000-04:00
diff --git a/additionaldocs/getting-started/README.md b/additionaldocs/getting-started/README.md
@@ -1,15 +1,28 @@
 # Getting Started
 
-This project contains the code needed to create a Docker image of the Graph
-Explorer. The image will create the Graph Explorer application and proxy server
-that will be served over the standard HTTP or HTTPS ports (HTTPS by default).
+This section helps new users install and configure Graph Explorer for the first
+time.
 
-The proxy server will be created automatically, but will only be necessary if
-you are connecting to Neptune. Gremlin-Server and BlazeGraph can be connected to
-directly. Additionally, the image will create a self-signed certificate that can
-be optionally used.
+## Files in this section
 
-## Examples
+1. [First Connection](first-connection.md) - Connecting to your first database
+
+## Prerequisites
+
+- Graph Explorer installed and running (see [Deployment](../deployment/) guides)
+- Access to a graph database endpoint
+- Basic familiarity with graph databases
+
+## Quick Start Steps
+
+1. **Deploy Graph Explorer** - Choose a deployment method from the
+   [Deployment](../deployment/) section
+2. **Configure your database** - Follow the
+   [First Connection](first-connection.md) guide for your database type
+3. **Create a connection** - Use the
+   [Connections UI](../user-guide/connections.md) to set up your connection
+4. **Start exploring** - Begin using Graph Explorer with the
+   [User Guide](../user-guide/)
 
 ## Troubleshooting
 
diff --git a/additionaldocs/getting-started/first-connection.md b/additionaldocs/getting-started/first-connection.md
@@ -0,0 +1,61 @@
+# First Connection
+
+This guide contains detailed instructions that help when configuring Graph
+Explorer with different graph database engines for the first time. After setting
+up your database, see the [Connections UI](../user-guide/connections.md) guide
+to learn how to create and manage connections within Graph Explorer.
+
+## Connecting to Neptune
+
+- Ensure that Graph Explorer has access to the Neptune instance by being in the
+  same VPC or VPC peering.
+- If authentication is enabled, read query privileges are needed (See
+  [ReadDataViaQuery managed policy](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-access-examples.html#iam-auth-data-policy-example-read-query)).
+
+## Connecting to Gremlin-Server
+
+If you are using the default Gremlin Server docker image, you can get the server
+running with the following commands:
+
+```
+docker pull tinkerpop/gremlin-server:latest
+docker run -p 8182:8182 \
+    tinkerpop/gremlin-server:latest \
+    conf/gremlin-server-rest-modern.yaml
+```
+
+### Enable REST
+
+Graph Explorer only supports HTTP(S) connections. When connecting to
+Gremlin-Server, ensure it is configured with a channelizer that supports HTTP(S)
+(i.e.
+[Channelizer Documentation](https://tinkerpop.apache.org/javadocs/current/full/org/apache/tinkerpop/gremlin/server/Channelizer.html)).
+
+<!-- prettier-ignore -->
+> [!TIP] 
+> The Gremlin Server configuration can be usually found at:
+>
+> ```
+> /conf/gremlin-server.yaml
+> ```
+
+### Versions Prior to 3.7
+
+If you have a version of Gremlin Server prior to 3.7, you will need to make the
+following changes:
+
+- **Enable property returns** - Remove
+  ".withStrategies(ReferenceElementStrategy)" from
+  `/scripts/generate-modern.groovy` so that properties are returned.
+- **Enable string IDs** - Change `gremlin.tinkergraph.vertexIdManager` and
+  `gremlin.tinkergraph.edgeIdManager` in `/conf/tinkergraph-empty.properties` to
+  support string ids. You can use `ANY`.
+- Build and run the Docker container as normal.
+
+## Connecting to BlazeGraph
+
+- Build and run the Docker container as normal and connect the proxy-server to
+  BlazeGraph and your workbench to the proxy-server.
+- If using Docker, ensure that the container running the workbench can properly
+  access the container running BlazeGraph. You can find documentation on how to
+  connect containers via [Docker networks](https://docs.docker.com/network/).
diff --git a/additionaldocs/user-guide/README.md b/additionaldocs/user-guide/README.md
@@ -5,8 +5,7 @@ features and connect to different graph databases.
 
 ## Files in this section
 
-1. [Connections](connections.md) - Database configuration and connection
-   management
+1. [Connections](connections.md) - Managing database connections in the UI
 2. [Settings](settings.md) - Application settings and configuration management
 3. [Graph Explorer](graph-explorer.md) - Main graph visualization interface
 4. [Table View](table-view.md) - Tabular data view and export functionality
diff --git a/additionaldocs/user-guide/connections.md b/additionaldocs/user-guide/connections.md
@@ -1,69 +1,8 @@
-# Connections
+# Connections UI
 
-This guide covers both how to configure Graph Explorer with different graph
-database engines and how to manage connections within the application.
-
-## Database Configuration
-
-This section contains detailed instructions that help when configuring Graph
-Explorer with different graph database engines.
-
-### Connecting to Neptune
-
-- Ensure that Graph Explorer has access to the Neptune instance by being in the
-  same VPC or VPC peering.
-- If authentication is enabled, read query privileges are needed (See
-  [ReadDataViaQuery managed policy](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-access-examples.html#iam-auth-data-policy-example-read-query)).
-
-### Connecting to Gremlin-Server
-
-If you are using the default Gremlin Server docker image, you can get the server
-running with the following commands:
-
-```
-docker pull tinkerpop/gremlin-server:latest
-docker run -p 8182:8182 \
-    tinkerpop/gremlin-server:latest \
-    conf/gremlin-server-rest-modern.yaml
-```
-
-#### Enable REST
-
-Graph Explorer only supports HTTP(S) connections. When connecting to
-Gremlin-Server, ensure it is configured with a channelizer that supports HTTP(S)
-(i.e.
-[Channelizer Documentation](https://tinkerpop.apache.org/javadocs/current/full/org/apache/tinkerpop/gremlin/server/Channelizer.html)).
-
-<!-- prettier-ignore -->
-> [!TIP] 
-> The Gremlin Server configuration can be usually found at:
->
-> ```
-> /conf/gremlin-server.yaml
-> ```
-
-#### Versions Prior to 3.7
-
-If you have a version of Gremlin Server prior to 3.7, you will need to make the
-following changes:
-
-- **Enable property returns** - Remove
-  ".withStrategies(ReferenceElementStrategy)" from
-  `/scripts/generate-modern.groovy` so that properties are returned.
-- **Enable string IDs** - Change `gremlin.tinkergraph.vertexIdManager` and
-  `gremlin.tinkergraph.edgeIdManager` in `/conf/tinkergraph-empty.properties` to
-  support string ids. You can use `ANY`.
-- Build and run the Docker container as normal.
-
-### Connecting to BlazeGraph
-
-- Build and run the Docker container as normal and connect the proxy-server to
-  BlazeGraph and your workbench to the proxy-server.
-- If using Docker, ensure that the container running the workbench can properly
-  access the container running BlazeGraph. You can find documentation on how to
-  connect containers via [Docker networks](https://docs.docker.com/network/).
-
-## Connections UI
+This guide covers how to manage connections within the Graph Explorer
+application. For information on configuring different graph database engines,
+see the [First Connection](../getting-started/first-connection.md) guide.
 
 You can create and manage connections to graph databases using this feature.
 Connections is accessible as the first screen after deploying the application,
