packages/admin-api-schema/src/schemas/README.md
When adding a new schema or definition following naming convention should be followed:
tags.json{resourceName}-{methodName}.json. For example, for tags.edit method file would be named tags-edit.jsonindex.ts. Add action schemas to actionSchemaNames so they are returned by list().The need to have separate "definitions" and "schema" files comes from schema reusability pattern that JSON schema allows for through $ref keyword. In some cases, the pattern doesn't quite work out because of limitations of the syntax (cannot override parts of referenced definition). Generally try to reuse as much schema as possible to avoid duplication unless it becomes painful to do so.