Pass extension documentation into schema

[numbata]

This PR allows to handle x- extension documentation specifically for object type fields in the OpenAPI schema.

For example, it helps to make some fields nullable without modifying the referenced object type with a x-nullable: true option like:

expose :foo, using: Foo, documentation: {description: "A foo nullable relation", x: { nullable: true } }

and have in the schema:

      foo:
        "$ref": "#/definitions/Foo
        x-nullable: true
        description: A foo nullable relation

[numbata]

@LeFnord @mscrivo Can you have a look at the PR, please?

[mscrivo]

Looks good to me, can we add a test to validate the expected behavior?

[numbata]

Actually, I just modified the current one, to ensure that it works as expected.
https://github.com/ruby-grape/grape-swagger-entity/pull/64/files#diff-a82dc4f43547c50c91c3c7c0c0fd378a6c0eacc0b0d3272ec419796ddb44de2fR63-R64

[numbata]

Also, I see that the workflow should be updated with a new Ruby version. I will do it in a separate PR.

[mscrivo]

also don't forget to add an entry to the changelog

[numbata]

Also, I see that the workflow should be updated with a new Ruby version. I will do it in a separate PR.

done here: #65

[numbata]

also don't forget to add an entry to the changelog

done here 7245469.

[numbata]

@mscrivo Thank you for approval!
:fyi: Currently omw in making a PR with updating dependencies for the grape's danger gem.
It should unblock #65 which should unblock this PR.

[mscrivo]

Thanks! Will merge this in and try to figure out the danger issues separately and get a release out asap.

[mscrivo]

@mscrivo Thank you for approval! :fyi: Currently omw in making a PR with updating dependencies for the grape's danger gem. It should unblock #65 which should unblock this PR.

Ah I missed this, I had started down the same path: ruby-grape/danger#11 Is that what you were thinking as well?

[numbata]

Yeah, the same path. Answered here: #65 (comment)