doc clarification

Author: taddes

docs/src/open-api-docs.md

@@ -4,8 +4,17 @@
 
 This project uses [utoipa](https://crates.io/crates/utoipa) and [utoipa-swagger-ui](https://crates.io/crates/utoipa-swagger-ui) to provide interactive API documentation.
 
-### Accessing the Documentation
+### Accessing and Working With the Documentation
+It is suggested to use the stage instance of Sync and/or Tokenserver when playing with the API,
+though you may also interact with your data in the production instance.
 
+Please take care to select the URL for Tokenserver for Tokenserver requests and the Syncstorage URL for Syncstorage requests.
+
+The Prod and Stage environments below will be available as a drop-down in the SwaggerUI:
+- **Sync Stage**: `https://sync-us-west1-g.sync.services.allizom.org`.
+- **Sync Prod**: `https://sync-1-us-west1-g.sync.services.mozilla.com`.
+- **Tokenserver Stage**: `https://stage-tokenserver.sync.nonprod.webservices.mozgcp.net`.
+- **Tokenserver Prod**: `https://prod-tokenserver.sync.prod.webservices.mozgcp.net`.
 #### On GitHub Pages (Static Documentation):
 
 The project automatically publishes API documentation to GitHub Pages:
@@ -15,14 +24,7 @@ The project automatically publishes API documentation to GitHub Pages:
 - **OpenAPI/Swagger UI**: https://mozilla-services.github.io/syncstorage-rs/swagger-ui/
 
 #### When the service is running (live deployment):
-It is suggested to use the stage instance of Sync and/or Tokenserver when playing with the API,
-though you may also interact with your data in the production instance.
-
-The Prod and Stage environments below will be available as a drop-down in the SwaggerUI:
-- **Sync Stage**: `https://sync-us-west1-g.sync.services.allizom.org`.
-- **Sync Prod**: `https://sync-1-us-west1-g.sync.services.mozilla.com`.
-- **Tokenserver Stage**: `https://stage-tokenserver.sync.nonprod.webservices.mozgcp.net`.
-- **Tokenserver Prod**: `https://prod-tokenserver.sync.prod.webservices.mozgcp.net`.
+I
 
 URLs for Swagger and OpenAPI Spec:
 - **Swagger UI (Interactive)**: `https://<your-deployment-url>/swagger-ui/`