Fix: Standardize allOf and Page schema structure for OpenAPI compliance

[jeffcumpsty-tpx]

• Move allOf to be the primary wrapper instead of sibling to properties
• Add explicit type: object and required fields for contents
• Fixes pagination schema validation issues with modern tools
• Resolves Standardize allOf and Page schema structure across repository versions #585
• Resolves Inverted operationId values for taxonomy endpoints #589

Description

standardize allOf composition in openapi.json

• Restructured paginated response schemas to use a top-level allOf array.
• Resolved "Sibling Property" conflicts where contents and Page metadata were not merging in validation engines.

Operation ID Correction:

• Swapped the inverted operationId values for /taxonomy_terms and /taxonomy_terms/{id} to ensure correct mapping
• in generated client SDKs.

Merge checklist

• Update the changelog

If you have edited any schema files:

• Run hsds_schema.py to update datapackage.json and example files

If you are working towards a new MINOR release:

• Update any $id values in schema files where appropriate
• Update the $ref values in openapi.json

[mrshll1001]

Excellent, thanks for this. Especially considering you've had to make three PRs for each MINOR version!

This looks good in terms of the update. Once #586 has been rebased, I'll submit the entirety of them to the PATCH process in the forum and assuming there's no issues, I can merge and issue the PATCHes in a week.