[need] Add nullable property to openapi.yml

[liverocaisson]

Scribe version

4.19.1

Your question

First, thank you for maintaining scribe.

The generated openapi.yml is not usable in swagger or spotlight if there's a property with null value.
Those properties are reported as errors.

OpenAPI v3 allow to use null value by adding the property "nullable".

https://stackoverflow.com/questions/48111459/how-to-define-a-property-that-can-be-string-or-null-in-openapi-swagger

As suggested bellow:

type: string
nullable: true

If we use nullable property, the error is resolved.

It would be very useful if we can set properties as nullable in the specification of parameters with Scribe.
https://scribe.knuckles.wtf/laravel/documenting/query-body-parameters

Thank you.

Docs

• I've checked the docs, the troubleshooting guide, and existing issues, but I didn't find a solution

[shalvah]

Sure, can you send in a PR for this?

[NoahNxT]

@liverocaisson Any updates on a PR?

[liverocaisson]

Actually I don't know how to implement it in Scribe

[shalvah]

How far did you go, though? The Scribe codebase isn't difficult to get started with (some parts are tricky, yes, but the OpenAPISpecWriter is one of the more straightforward parts).

[liverocaisson]

Thank you for your comment with the hint about where to modify it.

@shalvah @NoahNxT

I tried to modify the OpenAPISpecWriter here the PR
#739