spurious subschema if there are doc comments about schemars

[GREsau]

This is by-design. The schema_for macro generates schemas which conform to JSON Schema Draft 7, which does not allow an object with the $ref property to contain any other properties (see https://tools.ietf.org/html/draft-handrews-json-schema-01#section-8.3). So in order to include any other properties (including description), the $ref is wrapped in an allOf.

The newest JSON Schema specification (draft 2019-09) does not have this restriction. Schemars supports this, albeit in a more verbose way:

let schema = SchemaSettings::draft2019_09()
    .into_generator()
    .into_root_schema_for::<A>();
println!("{}", serde_json::to_string_pretty(&schema).unwrap());

Which would then output:

{
  "$schema": "https://json-schema.org/draft/2019-09/schema",
  "title": "A",
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "description": "doc comment",
      "$ref": "#/definitions/Name"
    }
  },
  "definitions": {
    "Name": {
      "type": "string"
    }
  }
}

[ahl]

Thanks; sorry for the noise.