Swagger does not reference correct schema when using embedded resource

[Toflar]

Sorry guys, I tried to provide a PR directly but the DocumentationNormalizer is a bit too complex at the moment. I don't quite see how all these names go together so here's the issue. If you can guide me I can help with a PR.

/**
 * @ApiResource(
 *     attributes={
 *         "normalization_context"={"groups"={"Quickcheck_GET"}},
 *         "denormalization_context"={"groups"={"Quickcheck_POST"}
 *    }
 * })
 */
class Quickcheck
{
    /**
     * @var QuickcheckAnswer[]
     *
     * @ORM\OneToMany(targetEntity="QuickcheckAnswer", mappedBy="quickcheck", cascade={"all"})
     * @ApiSubresource
     * @Groups({"Quickcheck_GET", "Quickcheck_POST"})
     */
    private $quickcheckAnswers;
}

/**
 * @ApiResource(
 *     attributes={
 *         "normalization_context"={"groups"={"QuickcheckAnswer_GET"}},
 *         "denormalization_context"={"groups"={"QuickcheckAnswer_POST", "Quickcheck_POST"}}
 *    }
 * )
 */
class QuickcheckAnswer {}

So I can POST to /quickcheck like so just fine:

    {
      "quickcheckAnswers":[
        {
          "key":"foo",
          "value":"whatever"
        },
        {
          "key":"foo2",
          "value":"whatever2"
        }
      ]
    }
    """

it all gets deserialized and updated correctly, awesome! But swagger shows me this:

I'd expect it to embed the schema instead.
I don't quite understand why there's a model for each combination of all groups because @Groups({"Quickcheck_GET", "Quickcheck_POST"}) means either Quickcheck_GET or Quickcheck_POST, imho.

Thanks for the help!

[soyuka]

Closing in favor of #2706