255 Commits

Author SHA1 Message Date
Athanasius
2a8d09e378
schemas: fcmaterials_capi: README: First cut 2022-09-02 16:27:48 +01:00
Athanasius
af2b29a4a4
schemas: fcmaterials_capi: Initial schema and README
* NB: The README is a straight copy of the _journal one right now.  Will fix
  later.
2022-09-02 15:41:07 +01:00
Athanasius
33d6e8fe2e
schemas: fcmaterials_journal: Fix $id from rename 2022-09-02 13:48:37 +01:00
Athanasius
b3876824f7
schemas/README: Document $id conventions
1. Get the designation of the version correct.
2. That empty `#` fragment is a SHOULD NOT, so just don't.
3. Append `_<source>` to the "filename" where necessary.
2022-09-02 13:46:18 +01:00
Athanasius
08127d261f
schemas/README: Per-schema README is now mandatory
I think I only made this 'SHOULD' before because at that stage I'd not yet
written the README files for the legacy schemas.
2022-09-02 13:38:53 +01:00
Athanasius
2eb213d766
schemas/TEMPLATES/journal: Remove the # 'fragment' from end of $id
As per <https://json-schema.org/draft/2020-12/json-schema-core.html#section-8.2.1>

> Therefore, "$id" MUST NOT contain a non-empty fragment, and SHOULD NOT contain an empty fragment.
2022-09-02 13:36:43 +01:00
Athanasius
5bcdfadb09
schemas: Rename Journal-only to fcmaterials_journal/1 2022-09-02 13:21:03 +01:00
Athanasius
61ef74492d
Revert "schemas: fcmaterials: Adjust to allow for CAPI-sourced data"
This reverts commit f4b9eab178efd2ea62e780b1c98ad5f8cf151e55.
2022-09-02 13:19:46 +01:00
Athanasius
f4b9eab178 schemas: fcmaterials: Adjust to allow for CAPI-sourced data
* Add new mandatory `data-source` field.
* `CarrierName` now optional (not in CAPI data).
* `Items` is defined a lot more loosely, due to Journal vs CAPI
  differences.
2022-08-31 15:23:06 +00:00
Athanasius
f4ab9eb35a
schemas: fcmaterials/1: Add README 2022-08-30 17:23:01 +01:00
Athanasius
2d2a205c7a
schemas: New fcmaterials/1 based on the *Journal* data source only 2022-08-30 17:23:00 +01:00
Athanasius
723e966b37
docs/README schemas: Be explicit about sub-second timestamp resolution 2022-06-24 14:48:11 +01:00
Athanasius
5d945297e1
schemas/fsssignaldiscovered: timestamp required per signal 2022-06-15 12:42:53 +01:00
Athanasius
3dbfd18188
schemas/fsssignaldiscovered: Rework for per-signal timestamp & misc. clarifications
* Per-signal `timestamp` due to the nature of USS signals.
* Keeping `message`->`timestamp` so any Listener relying on it being there
  isn't tripped up (it's present in all other schemas).
* Specifiy that each `signals` member should have `event` key/value pair
  removed.
* Mandate removal of `SystemAddress` from each `signals` member.
* Receivers: Only `horizons` and `odyssey` augmentations are optional.
* Updated examples for these changes.
2022-06-15 11:52:25 +01:00
Athanasius
d33c752c36
schemas/fsssignaldiscovered: README: Remove timestamp/SystemAddress from each signal 2022-06-14 14:03:49 +01:00
Athanasius
86f56eaac2
schemas/fsssignaldiscovered README: Reworked for changed schema
* Purely event-based batching, no timer.
* Outline Horizons/Odyssey differences.
* Point out that USS are manually scanned, so different in time nature.
* StarSystem renamed from systemName.
* StarSystem and StarPos now mandatory.
2022-06-14 14:01:36 +01:00
Athanasius
329d59831f
schemas/fsssignaldiscovered: Rework based on in-game findings
1. Unix, not DOS, line-endings.
2. `message`->`timestamp` instead of per signal.
3. `message`->`SystemAddress` instead of per signal.
4. `StarSystem` and `StarPos` augmentations now mandatory.
2022-06-14 13:59:13 +01:00
732de9bdd6
FSSSignalDiscovered doc 2022-06-13 22:40:08 +03:00
fb9904306b
FSSSignalDiscovered doc: add examples 2022-06-13 22:40:08 +03:00
03caeaa20c
FSSSignalDiscovered: initial documentation 2022-06-13 22:40:05 +03:00
6dbc9e392a
FSSSignalDiscovered: don't pass $USS_Type_MissionTarget; USS_Type 2022-06-13 22:36:12 +03:00
5386ed2c64
FSSSignalDiscovered: add properties 2022-06-13 22:36:12 +03:00
036e918fe9
FSSSignalDiscovered: optional systemName and StarPos 2022-06-13 22:36:12 +03:00
912fa0e064
WIP: FSSSignalDiscovered event support 2022-06-13 22:35:58 +03:00
Athanasius
85031ba2b0
schemas/template: Update template for StarSystem default & cross-checks
* New schemas will need to use `StarSystem`, not `SystemName` or `System`, if
  applicable, so have that example here.
* Any such augmentations need the cross-check mandating.
2022-05-31 13:21:49 +01:00
Athanasius
c3149f06bc
schemas/journal: Better word StarSystem and StarPos Augmentation docs
And also include the MUST about cross-checks.
2022-05-29 15:41:13 +01:00
Athanasius
bc628bff6f
schemas/journal: All relevant events already have SystemAddress
So there's no need to document it as an augmentation.  This was an error
based on examining the EDMC code.
2022-05-29 15:37:44 +01:00
Athanasius
e78ecc4ae7
schemas/scanbarycentre: Senders MUST apply cross-check on augmentations 2022-05-29 15:07:36 +01:00
Athanasius
c47699f11a
schemas/navbeaconscan: Senders MUST apply cross-check on augmentations 2022-05-29 15:05:01 +01:00
Athanasius
209a02a3bb
schemas/fssdiscoveryscan: Senders MUST apply cross-check on StarPos augmentation 2022-05-29 15:03:17 +01:00
Athanasius
fbdd531372
schemas/fssallbodiesfound: Senders MUST apply cross-check on StarPos augmentation 2022-05-29 15:00:44 +01:00
Athanasius
509521dd83
schemas/codexentry: Senders MUST apply cross-check on StarPos augmentation 2022-05-29 14:57:54 +01:00
Athanasius
3b84e851b8
schemas/approachsettlement: Senders MUST apply cross-checks on augmentations 2022-05-29 14:48:42 +01:00
Athanasius
d10b081be4
docs: Outline rules and caveats about data Augmentations
* Many will need a location cross-check.
* Call out this need in the fssbodysignals README.
2022-05-29 14:17:30 +01:00
Athanasius
370cef676f schemas/fssbodysignals: Use StarSystem not SystemName
This matches what's done in other schemas, and allows for use of common
code in EDMC.
2022-05-29 12:36:53 +00:00
Athanasius
8e5b17acdd schemas/fssbodysignals: Augment also with SystemName (as per schema) 2022-05-29 11:18:53 +00:00
Gareth Harper
cda25f4882 added missing BodyName field 2022-05-25 15:46:13 +00:00
Gareth Harper
bece26156e added fss body signals journal event 2022-05-25 14:39:55 +00:00
Athanasius
77a2d41d96
approachsettlement/1: Allow MarketID to be optional & document why 2022-02-19 11:29:19 +00:00
Athanasius
6ac735b1ac
schemas/navbeacon: Removing dangling comma 2022-01-31 10:31:07 +00:00
Athanasius
a1a20f511a
schemas/codexentry: Don't linkify 'Journal'
That section is gone/moved/renamed, and this is un-necessary anyway.
2022-01-30 17:38:38 +00:00
Athanasius
3474fcc8da
schemas/READMEs: Fix the 'horizons and odyssey' link
It was 'correct' in the template, but that's a directory deeper.  Some
instances were still pointing at the wrong file.
2022-01-30 17:25:28 +00:00
Athanasius
a07e2ad86a
schemas/outfitting: Fix 'capi lag' link to new location 2022-01-30 17:16:30 +00:00
Athanasius
5492b4fb60
schemas/shipyard: Align with current standards 2022-01-30 17:14:59 +00:00
Athanasius
6b213795e5
schemas/scanbarycentre: Bring in line with current standards 2022-01-30 16:54:58 +00:00
Athanasius
ec781aa94f
schemas/misc READMEs: Remove extraneous 'over ' 2022-01-30 16:40:28 +00:00
Athanasius
c903df1dd5
schemas/outfitting: Bring in line with current standards 2022-01-30 16:39:35 +00:00
Athanasius
cb849f3d9e
schemas/template: Minor grammar tweak to README 2022-01-30 16:38:43 +00:00
Athanasius
2969bb2eb1
schemas/navroute: Bring in line with current standards 2022-01-30 16:16:46 +00:00
Athanasius
adcf6b6010
schemas/navbeaconscan: Bring in line with current standards 2022-01-30 16:13:56 +00:00