danielgtaylor / aglio

An API Blueprint renderer with theme support that outputs static HTML
4.75k stars 480 forks source link

Why using custom example generator instead of relying on protagonist output? #348

Open goganchic opened 6 years ago

goganchic commented 6 years ago

https://github.com/danielgtaylor/aglio/commit/c14f143d2bc1495ca418ff8b2938c2594fe21ad6 this commit is a source of such problem:

# Foo

# Data Structures

## Test (object)
+ One Of
    + Properties
        + A: x (enum, required)
        + B: x (required, string)
    + Properties
        + A: y (enum, required)
        + C: y (required, string)
    + Properties
        + A: z (enum, required)

# GET /foo
+ Response 200 (application/json)
    + Attributes (Test)

Such doc gives {"A": "x"} as an example instead of {"A": "x", "B": "x"}. Is it essential now to generate examples using aglio instead of using protagonist output?