Some nits: - Can we add more description or examples to property - For example 1: value should come first in the response example - Example 2: an we add more description? And especially highlight `in` or `out` <img width="806" alt="image" src="https://user-images.githubusercontent.com/6052978/189775248-35478d98-e5e9-4950-a3ee-5ceaf6009dea.png">