From a32d6e2ea337650bdc18b8a3c810e0939a04337a Mon Sep 17 00:00:00 2001
From: Athanasius <github@miggy.org>
Date: Mon, 1 Nov 2021 15:11:15 +0000
Subject: [PATCH] schemas: outfitting: README: Initial version

---
 schemas/outfitting-README.md | 41 ++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 schemas/outfitting-README.md

diff --git a/schemas/outfitting-README.md b/schemas/outfitting-README.md
new file mode 100644
index 0000000..f3e4370
--- /dev/null
+++ b/schemas/outfitting-README.md
@@ -0,0 +1,41 @@
+# EDDN Outfitting Schema
+
+## Introduction
+Here we document how to take data from an ED `Outfitting` Journal
+Event and properly structure it for sending to EDDN.
+
+Please consult [EDDN Schemas README](./README-EDDN-schemas.md) for general
+documentation for a schema such as this.
+
+## Senders
+The primary data source for this schema is the ED Journal event
+`Outfitting`.
+
+You MAY also source this data from the CAPI `/shipyard` endpoint.  See
+[commodity-README.md#using-capi-data](commodity-README.md#using-capi-data)
+for guidance on this.
+
+You only need the `name` key's value for each member of the `modules` array.
+
+### Key Renames
+Many of the key names have a different case defined in this schema, make
+sure you are renaming them as appropriate.
+
+### Elisions
+Remove items whose availability depends on the Cmdr's status rather than on the
+station. Namely:
+
+- Items that aren't weapons/utilities (`Hpt_*`), standard/internal
+  modules (`Int_*`) or armour (`*_Armour_*`) (i.e. bobbleheads, decals,
+  paintjobs and shipkits).  This is enforced by the schema.
+- Items that have a non-null `"sku"` property, unless
+  it's `"ELITE_HORIZONS_V_PLANETARY_LANDINGS"` (i.e. PowerPlay and tech
+  broker items).
+- The `"Int_PlanetApproachSuite"` module (for historical reasons).
+
+### Augmentations
+#### horizons flag
+You SHOULD add this key/value pair, using the value from the `LoadGame` event.
+
+#### odyssey flag
+You SHOULD add this key/value pair, using the value from the `LoadGame` event.
\ No newline at end of file