docs: fix broken links, invalid JSON, and unclear terminology (#1697)

Author: kmcginnes

docs/getting-started/README.md

@@ -4,7 +4,7 @@ Graph Explorer is distributed as a Docker image. The image includes the Graph Ex
 
 ## Try It Out
 
-The fastest way to try Graph Explorer is with the [Air Routes sample](../../samples/air_routes/readme.md). It launches Graph Explorer and a Gremlin Server pre-loaded with sample data using Docker Compose — no database setup or AWS account required.
+The fastest way to try Graph Explorer is with the [Air Routes sample](../../samples/air_routes/README.md). It launches Graph Explorer and a Gremlin Server pre-loaded with sample data using Docker Compose — no database setup or AWS account required.
 
 ### Prerequisites
 

docs/guides/connecting-to-blazegraph.md

@@ -1,4 +1,4 @@
 # 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/).
+- Build and run the Docker container as normal and connect Graph Explorer to BlazeGraph through the proxy server.
+- If using Docker, ensure that the container running Graph Explorer can properly access the container running BlazeGraph. You can find documentation on how to connect containers via [Docker networks](https://docs.docker.com/network/).

docs/guides/troubleshooting.md

@@ -32,7 +32,7 @@ Which will result in the following URLs:
 
 ### HTTP Only
 
-If you do not want to use SSL and HTTPS, you can disable it by setting the following [environment variables](/docs/development.md#environment-variables):
+If you do not want to use SSL and HTTPS, you can disable it by setting the following [environment variables](../development.md#environment-variables):
 
 ```
 PROXY_SERVER_HTTPS_CONNECTION=false
@@ -65,7 +65,7 @@ The following instructions can be used as an example to bypass the warnings for
 <!-- prettier-ignore -->
 > [!TIP]
 > To get rid of the "Not Secure" warning, see
-[Using self-signed certificates on Chrome](/docs/development.md#using-self-signed-certificates-on-chrome).
+[Using self-signed certificates on Chrome](../development.md#using-self-signed-certificates-on-chrome).
 
 ## Schema Sync Fails
 
@@ -165,5 +165,5 @@ New Neptune Notebooks automatically apply the correct IAM permissions to write t
 
 Below are examples of which IAM permissions you need for Graph Explorer.
 
-- [IAM permissions for Neptune DB](/docs/guides/deploy-to-sagemaker/graph-explorer-neptune-db-policy.json)
-- [IAM permissions for Neptune Analytics](/docs/guides/deploy-to-sagemaker/graph-explorer-neptune-analytics-policy.json)
+- [IAM permissions for Neptune DB](./deploy-to-sagemaker/graph-explorer-neptune-db-policy.json)
+- [IAM permissions for Neptune Analytics](./deploy-to-sagemaker/graph-explorer-neptune-analytics-policy.json)

docs/references/default-connection.md

@@ -27,24 +27,24 @@ These are the valid environment variables used for the default connection, their
 
 First, create a `config.json` file containing values for the connection attributes:
 
-```js
+```json
 {
   "PUBLIC_OR_PROXY_ENDPOINT": "https://public-endpoint",
   "GRAPH_CONNECTION_URL": "https://{your-cluster-id}.us-west-2.neptune.amazonaws.com:8182",
   "USING_PROXY_SERVER": true,
   "IAM": true,
   "SERVICE_TYPE": "neptune-db",
   "AWS_REGION": "us-west-2",
-  // Possible Values are "gremlin", "sparql", "openCypher"
   "GRAPH_TYPE": "gremlin",
   "GRAPH_EXP_HTTPS_CONNECTION": true,
   "PROXY_SERVER_HTTPS_CONNECTION": true,
-  // Measured in milliseconds (i.e. 240000 is 240 seconds or 4 minutes)
   "GRAPH_EXP_FETCH_REQUEST_TIMEOUT": 240000,
-  "GRAPH_EXP_NODE_EXPANSION_LIMIT": 500,
+  "GRAPH_EXP_NODE_EXPANSION_LIMIT": 500
 }
 ```
 
+`GRAPH_TYPE` accepts `"gremlin"`, `"sparql"`, or `"openCypher"`. `GRAPH_EXP_FETCH_REQUEST_TIMEOUT` is measured in milliseconds (e.g., 240000 is 4 minutes).
+
 Pass the `config.json` file path to the `docker run` command.
 
 ```bash

samples/README.md

@@ -6,4 +6,4 @@ These samples show possible configurations of Graph Explorer using open source d
 
 This sample uses Gremlin Server as the database pre-loaded with the air routes sample data and shows how to configure Graph Explorer to connect to it automatically with a default connection.
 
-[Air Routes](./air_routes/readme.md)
+[Air Routes](./air_routes/README.md)