chore(oas): [12/n] improve oas schemas (#9200)

- improve OAS schemas [12/n]
- Support ignoring properties in type if it has the `@ignore` jsdoc tag.

www/utils/packages/docs-generator/src/classes/kinds/oas.ts

@@ -1543,6 +1543,15 @@ class OasKindGenerator extends FunctionKindGenerator {
             ) {
               return
             }
+
+            const shouldIgnore = property
+              .getJsDocTags()
+              .some((tag) => tag.name === "ignore")
+
+            if (shouldIgnore) {
+              return
+            }
+
             if (this.isRequired(property)) {
               requiredProperties.push(property.name)
             }