Organizing building blocks by type first?

I feel it would make things a lot easier to maintain if we used as top-level subdirectories the following list:

• apiSpec (inside could be sub-directory for each part, and inside could be each conformance class)
• paths
• responses
• schemas
• queryParameters
• requestHeaders
• responseHeaders

This should make it easier to import and synchronize the different building blocks from existing specs which already use several of these directories, e.g.:

• https://github.com/opengeospatial/ogcapi-common/tree/master/core/openapi
• https://github.com/opengeospatial/ogcapi-common/tree/master/collections/openapi
• https://github.com/opengeospatial/ogcapi-features/tree/master/core/openapi
• https://github.com/opengeospatial/ogcapi-features/tree/master/extensions/crs/openapi
• https://github.com/opengeospatial/ogcapi-features/tree/master/extensions/transactions/create-replace-update-delete/openapi
• https://github.com/opengeospatial/ogcapi-coverages/tree/master/standard/openapi
• https://github.com/opengeospatial/ogcapi-maps/tree/master/openapi
• https://github.com/opengeospatial/ogcapi-tiles/tree/master/openapi
• https://github.com/opengeospatial/ogcapi-discrete-global-grid-systems/tree/master/openapi
• https://github.com/opengeospatial/ogcapi-environmental-data-retrieval/tree/master/standard/openapi
• https://github.com/opengeospatial/ogcapi-processes/tree/master/core/openapi

Entries in the registry should probably be in a machine-readable form like JSON rather than ASCIIDoc (to implement organization / filtering by type etc.), including all the properties needed to efficiently support the building blocks registry.
e.g., following properties could be included:

• title
• description
• maturity
• isGeoSpatial
• originatingSpec
• schema / definition
• ...

Compare the linked OGC API OpenAPI directories to understand the proposed building-block organization, then inspect how the current registry is represented in ASCIIDoc. The scope is complete only once the project agrees on the directory structure and the machine-readable registry properties and format.