search

apigear-io / cli

The ApiGear client as go project
https://apigear.io
MIT License
1 stars 2 forks source link

optional-schema qualifiers #138

Open jryannel opened 6 months ago

jryannel commented 6 months ago

We shall drop the schema qualifiers on the top of the documents, as they are not really enforced and we don't really have the bandwidth to enforce them. 

schema: apigear.module/1.0
name: tb.enum
version: "1.0.0"

will become

name: tb.enum
version: "1.0.0"

I expect for most customers the schema identifiers are more a unknown thing. If we could replace these later with a $id (see https://json-schema.org/understanding-json-schema/basics#declaring-a-unique-identifier) and a ref to the used json-schema (see https://json-schema.org/understanding-json-schema/basics#declaring-a-json-schema).

$schema: https://json-schema.org/draft/2020-12/schema
$id: http://apigear.io/schemas/v1/module.json
name: tb.enum
version: "1.0.0"

Make them optional

jryannel commented 5 months ago

The qualifiers should be optional and the if missing the latest should be assumed