Discussions

Ask a Question
Back to All

Is there a workaround for supporting "anyOf" in readme?

I am working to port over our docs and we use anyOf for an object type. Does readme support that structure? if not is there a workaround?

Also I am noticing that nested references within components/schemas are not rendering correctly.

eg:

Components: 
	Schemas: 
		schema1: 
			title: "a" 
		schema2: 
			title: "b" 
			variable1:
				ref: "#/components/schemas/schema1" 
		schema2: 
			title: "c" 
			variable2: 
				ref: "#/components/schemas/schema2"

Based on the above example, the API Reference does not render the details of nested schema from references, I,e schem2.variable1 is listed as an empty field and does not fully render the details of schema1

Is this expected behavior? Is there a way to help with this nesting issue? Our documentation has a lot of this type of nesting.