search

ConsumerDataStandardsAustralia / standards-staging

Other
1 stars 0 forks source link

Refer to components in Banking API spec #429

Open nils-work opened 2 months ago

nils-work commented 2 months ago

The Banking API spec repeats common details in every endpoint definition, including:

These common sections are also included in the components section of the spec but are not referenced. Referencing the component will reduce the file size, simplify maintenance and ensure consistency.

nils-work commented 2 months ago

Related to #183.

perlboy commented 2 months ago

@nils-work The component naming format will create a complete mess for codegen tools. Strongly recommend stealing our well structured Redocly repository, you and your customers will thank you: https://github.com/datarightplus/datarightplus-redocly

nils-work commented 2 months ago

Thanks @perlboy, these changes follow a similar convention to what has been used in the other specs, can you explain the issue?

nils-work commented 1 month ago

This change was approved in #353 - Decision Proposal 353 - Maintenance Iteration 20 but was not incorporated in Standards version 1.32.0.

nils-work commented 1 week ago

This has been staged: https://github.com/ConsumerDataStandardsAustralia/standards-staging/pull/430/files