From dd43262e41f1a6d6457e7b4950f5a71e6b40f8bd Mon Sep 17 00:00:00 2001
From: SpaceAdmiral <joel@spacetraders.io>
Date: Mon, 14 Mar 2022 17:35:39 -0700
Subject: [PATCH] Modified 2 files

---
 .stoplight.json             | 23 +++++++++++++++++++++++
 reference/SpaceTraders.yaml | 21 +++++++++++++++++----
 2 files changed, 40 insertions(+), 4 deletions(-)
 create mode 100644 .stoplight.json

diff --git a/.stoplight.json b/.stoplight.json
new file mode 100644
index 0000000..8359748
--- /dev/null
+++ b/.stoplight.json
@@ -0,0 +1,23 @@
+{
+  "exclude": [],
+  "formats": {
+    "openapi": {
+      "rootDir": "reference",
+      "include": [
+        "**"
+      ]
+    },
+    "json_schema": {
+      "rootDir": "models",
+      "include": [
+        "**"
+      ]
+    },
+    "markdown": {
+      "rootDir": "docs"
+    },
+    "image": {
+      "rootDir": "assets/images"
+    }
+  }
+}
\ No newline at end of file
diff --git a/reference/SpaceTraders.yaml b/reference/SpaceTraders.yaml
index e80a676..991e69e 100644
--- a/reference/SpaceTraders.yaml
+++ b/reference/SpaceTraders.yaml
@@ -10,11 +10,14 @@ info:
     name: 'No'
     url: 'https://choosealicense.com/no-permission/'
   description: |-
-    SpaceTraders is a unique multiplayer game built on a free Web API. You control a fleets of ships that can explore the universe, mine asteroids, automate trade routes, meet new factions, and discover hidden technology.
+    SpaceTraders is a multiplayer sci-fi strategy game where you acquire and manage a fleet of ships across a growing and dynamic universe.
 
-    Participate in one of our regular competitive seasons or build a client to share with the community.
+    Similar to games such as Eve Online, you work with or against other players to establish trade routes, chart new systems, mine precious ores, patrol for pirates, spy on factions, and discover hidden treasures.
+
+    But what makes our game unique? SpaceTraders is entirely accessible through open and well-documented Web API endpoints. In fact, SpaceTraders doesn't have a first-class client to play the game - if you want to take it for a spin, you should try one of our community-created web clients, or use the API documentation to see how you might play a game through an API.
+
+    If this sounds fun and interesting to you, please drop into our Discord and get to know the community. We are actively working on new clients, new ideas and sharing tips for how to play the game.
 
-    SpaceTraders is currently in an alpha stage of development. Join our Discord to learn more.
 
     ```json http
     {
@@ -202,7 +205,7 @@ paths:
                         - X1-ZZ
                         - X1-ZZ-7-EE
       operationId: 'post-my-ships-:shipSymbol-chart'
-      description: Chart a new system or waypoint.
+      description: 'Chart a new system or waypoint. Returns an array of the symbols that have been charted, including the system and the waypoint if both were uncharted, or just the waypoint.'
       security:
         - AgentToken: []
     parameters:
@@ -741,6 +744,15 @@ paths:
       operationId: post-my-ships-shipSymbol-jump
       security:
         - AgentToken: []
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                destination:
+                  type: string
+                  description: The system symbol to jump to.
     get:
       summary: Jump Cooldown
       operationId: get-my-ships-shipSymbol-jump
@@ -2195,3 +2207,4 @@ components:
       type: http
       scheme: bearer
       description: When you register a new agent you will be granted a private bearer token which grants authorization to use the API.
+  requestBodies: {}