Description argument not documented

[steverep]

The description argument for the Marker class (or any subclass) is not documented anywhere, so it's unclear what's allowed and how it affects the schema.

[spacegaier]

You can see in the PR that added that option (#307) it is not really used inside the library itself, but allows having a description that can then be used by the schema creator if required, e.g. for some introspection, see this issue with the reasoning behind that feature: #305

There is nothing specifically allowed for description. You can pass anything in.

[steverep]

Thanks for the explanation. Pasting something similar into the doc string would have saved me some confusion.