Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Decision Proposal 138 - Banking Maintenance Iteration 5 #138

Closed
CDR-API-Stream opened this issue Sep 17, 2020 · 14 comments
Closed

Decision Proposal 138 - Banking Maintenance Iteration 5 #138

CDR-API-Stream opened this issue Sep 17, 2020 · 14 comments
Labels
Category: API A proposal for a decision to be made for the API Standards made Category: CX A proposal for a decision to be made for the User Experience Standards Category: InfoSec Information Security Technical Working Group Decision Proposal Industry: Banking This proposal impacts the banking industry Status: Decision Made A determination on this decision has been made

Comments

@CDR-API-Stream
Copy link
Contributor

This decision will capture the outcome of Banking Maintenance Iteration 5. Consultation will commence on the change requests in the standards maintenance repository.

Initial consultation is being sought on the scope of the banking maintenance iteration and the prioritisation of change requests.

Schedule

Phase 1: Backlog Grooming - 16th September 2020 commencement. 2 weeks duration
Phase 2: Consultation - 30th September 2020 commencement. 4 weeks duration
Phase 3: Approval - 28th October 2020 commencement. 1 week duration
Phase 4: Documentation - 4th November 2020 commencement. 1 week duration


Meeting series

Note: To receive calendar invites for this series please email your request via our mailbox. To receive notifications of this meeting series and more subscribe to the DSB mailing list for regular updates.

The teleconferences to support the iteration have been scheduled as follows:

  • Call to discuss Maintenance Iteration # 5 Kick-off and backlog review | 16th September 2020 @2pm for 1 hour
  • Call to discuss Maintenance Iteration # 5 Consultation | 30th September 2020 @2pm for 1 hour
  • Call to discuss Maintenance Iteration # 5 Proposal Checkpoint | 14th October 2020 @2pm for 1 hour
  • Call to discuss Maintenance Iteration # 5 Approvals and Documentation | 28th October 2020 @2pm for 1 hour

Dial in details

@CDR-API-Stream CDR-API-Stream added Category: API A proposal for a decision to be made for the API Standards made Status: Open For Feedback Feedback has been requested for the decision Category: CX A proposal for a decision to be made for the User Experience Standards Category: InfoSec Information Security Technical Working Group Decision Proposal Industry: Banking This proposal impacts the banking industry labels Sep 17, 2020
@CDR-API-Stream
Copy link
Contributor Author

Meeting notes for the kickoff call for the maintenance iteration held on 16/09/2020 are available here: https://github.com/ConsumerDataStandardsAustralia/standards/wiki/DSB-Maintenance-Iteration-5:-Kickoff-&-Backlog-Grooming:-Agenda-&-Meeting-Notes-(16th-September-2020)

@CDR-API-Stream
Copy link
Contributor Author

@CDR-API-Stream
Copy link
Contributor Author

Meeting minutes for the iteration scope review and finalisation call held on 30/09/2020 are available here:
https://github.com/ConsumerDataStandardsAustralia/standards/wiki/DSB-Maintenance-Iteration-5:-Finalisation-of-Iteration-Scope:-Agenda-&-Meeting-Notes-(30th-September-2020).

An out of cycle call we be scheduled for 2pm - 3.30pm Wednesday 07/09/2020 to continue consultation on the list of change requests.

@CDR-API-Stream
Copy link
Contributor Author

Meeting agenda and dial in details for maintenance iteration 5 scope review call to be held on 07/10/2020 are available here:
https://github.com/ConsumerDataStandardsAustralia/standards/wiki/DSB-Maintenance-Iteration-5:-Iteration-Scope-Review:-Agenda-&-Meeting-Notes-(7th-October-2020)

This is a continuation of the scope discussion from last week.

Note, daylight savings time adjustments: 1pm - 2.30pm AEST (2pm - 3.30pm AEDT)

@CDR-API-Stream
Copy link
Contributor Author

Meeting minutes for the 5th maintenance iteration scope review call held on 07/10/2020 are available here: https://github.com/ConsumerDataStandardsAustralia/standards/wiki/DSB-Maintenance-Iteration-5:-Iteration-Scope-Review:-Agenda-&-Meeting-Notes-(7th-October-2020)

@CDR-API-Stream
Copy link
Contributor Author

The next maintenance iteration call originally scheduled for Wednesday 14th October 2020 will now be held on Thursday 15th October 2020 at 2pm AEDT. Updated calendar invites will be issued shortly.

Note, daylight savings time adjustments: 1pm - 2.00pm AEST (2pm - 3.00pm AEDT)

Meeting agenda and dial in details for the iteration checkpoint call are available here: https://github.com/ConsumerDataStandardsAustralia/standards/wiki/DSB-Maintenance-Iteration-5:-Iteration-Checkpoint:-Agenda-&-Meeting-Notes-(15th-October-2020).

@CDR-API-Stream
Copy link
Contributor Author

Meeting agenda and dial in details for maintenance iteration 5 checkpoint call for Thursday 15th October 2020 are available here: https://github.com/ConsumerDataStandardsAustralia/standards/wiki/DSB-Maintenance-Iteration-5:-Iteration-Checkpoint:-Agenda-&-Meeting-Notes-(15th-October-2020)

Note, daylight savings time adjustments: 1pm - 2.00pm AEST (2pm - 3.00pm AEDT)

@CDR-API-Stream
Copy link
Contributor Author

Meeting minutes for the 5th maintenance iteration checkpoint call held on 15/10/2020 are available here: https://github.com/ConsumerDataStandardsAustralia/standards/wiki/DSB-Maintenance-Iteration-5:-Iteration-Checkpoint:-Agenda-&-Meeting-Notes-(15th-October-2020).

@CDR-API-Stream
Copy link
Contributor Author

Meeting agenda and dial in details for maintenance iteration 5 checkpoint call for Thursday 15th October 2020 are available here: https://github.com/ConsumerDataStandardsAustralia/standards/wiki/DSB-Maintenance-Iteration-5:-Iteration-Checkpoint:-Agenda-&-Meeting-Notes-(28th-October-2020)

Note, daylight savings time adjustments: 1pm - 2.00pm AEST (2pm - 3.00pm AEDT).

@CDR-API-Stream
Copy link
Contributor Author

Please note, under this iteration, issue #325 on Standards Maintenance has been marked as urgent and a decision proposal created to obtain feedback. The Decision Proposal and issue context is available here: ConsumerDataStandardsAustralia/standards-maintenance#325 (comment)

@CDR-API-Stream
Copy link
Contributor Author

Meeting agenda and dial in details for maintenance iteration 5's final checkpoint call for Thursday 12th October 2020 are available here: https://github.com/ConsumerDataStandardsAustralia/standards/wiki/DSB-Maintenance-Iteration-5:-Final-Checkpoint:-Agenda-&-Meeting-Notes-(12th-November-2020).

Note, daylight savings time adjustments: 1pm - 2.00pm AEST (2pm - 3.00pm AEDT).

@CDR-API-Stream
Copy link
Contributor Author

Decision 325 was approved by the Data Standards Chair on 8/12/2020. Due to this change request being treated as urgent, a version 1.6.0 of the data standards will be released to address this specific change. The remainder of the change requests from maintenance iteration 5 which had consensus of community approval will be summarised in a subsequent decision record representing the remainder of maintenance iteration 5 and a target 1.7.0 release.

A link to the final approved decision is attached:
Decision 325 - Client Authentication Audience Claim.pdf

The changes to the technical data standards have been staged in standards-staging repository. The commit history is available here: ConsumerDataStandardsAustralia/standards-staging#3

@CDR-API-Stream
Copy link
Contributor Author

A community retrospective for maintenance iteration 5 was held on 2/12/2020. The retrospective board with feedback is available here: https://miro.com/app/board/o9J_ldyyO3Q=/

@ConsumerDataStandardsAustralia ConsumerDataStandardsAustralia locked and limited conversation to collaborators Feb 12, 2021
@CDR-API-Stream CDR-API-Stream added Status: Feedback Period Closed The feedback period is complete and a final decision is being formulated and removed Status: Open For Feedback Feedback has been requested for the decision labels Feb 12, 2021
@CDR-API-Stream
Copy link
Contributor Author

Changes arising from this maintenance iteration were approved by the Data Standards Chair for v1.7.0 of the Consumer Data Standards. The approved decision record is available here: #159

JamesMBligh added a commit that referenced this issue Mar 22, 2022
CDR-API-Stream added a commit that referenced this issue Mar 22, 2022
* Standards Staging Issue #115: Update text description of bulk balance for energy in endpoint version schedule

* Cleared out the diff comments presented on the Version Delta tab

* Added an empty release 1.16.0 release notes page

* Incremented version numbers for swagger files to 1.16.0

* Added archive link to 1.15.0

* Reverted back to standard (non-festive) logo

* Incremented version number in introduction

* Added normative reference link to RFC9126

* Added link to 1.16.0 release notes

* Corrected link for RFC2119

* Clarified requirements for Data Recipient Software Products S256 code challenge method by removing the redundant \'if supported\' text

* Standards Staging Issue #116 Change type of page and page-size in Energy APIs to PositiveInteger

* Updates for DP166

* Updates for DP166

* Removed duplicate section: Data Holders calling Data Recipients

* Corrected GetProducts response reference from ResponseBankingProductList to ResponseBankingProductListV2

* Removed the unintended additional formatting from the cds_banking.json to make diffs easier

* Corrected Register Discovery Document definition defect renaming request_object_signing_alg_values_supported to token_endpoint_auth_signing_alg_values_supported

* Corrected GetDataHolderBrands RegisterDataHolderAuth and jwksEndpoint schema definitions to clarify their usage in DH to ADR client authentication

* Standards Staging Issue #115: Updated release notes for this change

* fixed typos and ordering

* Removed tables

* Rechanged ordering

* Build and final checks

* Convert swagger to OAS
Remove 4xx error codes

* Rebuild

* Fix json typos
Update error codes for energy OAS

* Rebuild

* Added tooltip support for RFCs and normative/informative references. Also fixed invalid or missing RFC links

* Fixed markdown issue with normative references table

* Converted more normative reference links to dynamic tooltips

* Updated FAPI informative reference

* - Formatting improvements. - Added additional tooltip references

* - Moved normative references out of the Security section into the Introduction. - Added additional tooltip references

* Updated code generation for normative and informative references

* Added link to the endpoint versioning schedule to the high level standards

* Added 1.16.1 release notes

* Added release notes for Standards Staging issue 130

* Added release notes for Standards Staging issue 132

* Updated RFC4122 links in Banking and Common schemas to include tooltips

* poc secondary-dataholder-apis: Added changes to include Energy Secondary Data Holder OAS in standards

* Fix for staging 139

* fix #138

* Fix for #137

* Fix #136

* Fix #135

* Fix #134

* Initial build for review

* Update version number everywhere

* Add archive entry for 1.16.0
Clean up diff statements
Update release notes

* Fixes to SR swagger

* Update Swagger to OAS in markdown

* Updated Energy SDH swagger file to lastest version with fixes applied for error codes and attribute types

* Remove known issues that are resolved
Full rebuild

* Version bumps to address GitHub security notices

* Updated additional informative references to include tooltips

* Fix SDH security

* Fix for controlledLoad flag in energy
Rebuild

* Minor release notes and diff fixes

Co-authored-by: Hemang Rathod <[email protected]>
Co-authored-by: Ivan Hosgood <[email protected]>
Co-authored-by: Kirkycdr <[email protected]>
Co-authored-by: James Bligh <[email protected]>
Co-authored-by: James Bligh <[email protected]>
Co-authored-by: Mark Verstege <[email protected]>
CDR-API-Stream added a commit that referenced this issue May 23, 2022
* Standards Staging Issue #115: Update text description of bulk balance for energy in endpoint version schedule

* Cleared out the diff comments presented on the Version Delta tab

* Added an empty release 1.16.0 release notes page

* Incremented version numbers for swagger files to 1.16.0

* Added archive link to 1.15.0

* Reverted back to standard (non-festive) logo

* Incremented version number in introduction

* Added normative reference link to RFC9126

* Added link to 1.16.0 release notes

* Corrected link for RFC2119

* Clarified requirements for Data Recipient Software Products S256 code challenge method by removing the redundant \'if supported\' text

* Standards Staging Issue #116 Change type of page and page-size in Energy APIs to PositiveInteger

* Updates for DP166

* Updates for DP166

* Removed duplicate section: Data Holders calling Data Recipients

* Corrected GetProducts response reference from ResponseBankingProductList to ResponseBankingProductListV2

* Removed the unintended additional formatting from the cds_banking.json to make diffs easier

* Corrected Register Discovery Document definition defect renaming request_object_signing_alg_values_supported to token_endpoint_auth_signing_alg_values_supported

* Corrected GetDataHolderBrands RegisterDataHolderAuth and jwksEndpoint schema definitions to clarify their usage in DH to ADR client authentication

* Standards Staging Issue #115: Updated release notes for this change

* fixed typos and ordering

* Removed tables

* Rechanged ordering

* Build and final checks

* Convert swagger to OAS
Remove 4xx error codes

* Rebuild

* Fix json typos
Update error codes for energy OAS

* Rebuild

* Added tooltip support for RFCs and normative/informative references. Also fixed invalid or missing RFC links

* Fixed markdown issue with normative references table

* Converted more normative reference links to dynamic tooltips

* Updated FAPI informative reference

* - Formatting improvements. - Added additional tooltip references

* - Moved normative references out of the Security section into the Introduction. - Added additional tooltip references

* Updated code generation for normative and informative references

* Added link to the endpoint versioning schedule to the high level standards

* Added 1.16.1 release notes

* Added release notes for Standards Staging issue 130

* Added release notes for Standards Staging issue 132

* Updated RFC4122 links in Banking and Common schemas to include tooltips

* poc secondary-dataholder-apis: Added changes to include Energy Secondary Data Holder OAS in standards

* Fix for staging 139

* fix #138

* Fix for #137

* Fix #136

* Fix #135

* Fix #134

* Initial build for review

* Update version number everywhere

* Add archive entry for 1.16.0
Clean up diff statements
Update release notes

* Fixes to SR swagger

* Update Swagger to OAS in markdown

* Updated Energy SDH swagger file to lastest version with fixes applied for error codes and attribute types

* Remove known issues that are resolved
Full rebuild

* Version bumps to address GitHub security notices

* Updated additional informative references to include tooltips

* Fix SDH security

* Fix for controlledLoad flag in energy
Rebuild

* Minor release notes and diff fixes

* Standards Release 1.17.0: Added release notes file

* Standards Maintenance Issue #448: Changed percentOfBill, percentOfUse, fixedAmount and percentOverThreshold attributes from optional to conditional within EnergyPlanDiscounts schema

* Standards Release 1.17.0: Removed version deltas, incremented version numbers in swagger files, added archieve entry for 1.16.1

* Updates to baseline 1.17.0 to remove legacy diffs and include a link to the release notes

* Standards Maintenance Issue 503: Fixed documentation for CDR Arrangement Form Parameter and JWT method requirements

* Added scrollabe diffs and examples to support previous and next scrolling

* Added release notes

* Updated prev/next button titles

* Minor refactoring to remove unused vars

* Standards Maintenance Issue 504: Corrected the profile scope data language to clarify request of individual claims

* Added diff

* Standards Maintenance Issue #449: Made EnergyPlanSolarFeedInTariff.timeVaryingTariffs.timeVariations.days field mandatory

* Added proof of concept to highlight obligations in the endpoint versioning schedule based on a selected mileston date

* Added release notes

* Removed diff comments

* Fix for padding of last input field in datepicker

* Added collapsible obligations that hide any future, retired, and inactive obligations

* Tweaks to collapsed highlighting

* Updated release notes to include standards maintenance issue number

* Corrected release description

* Updated CDR Arrangement Recovation JWT documentation to articulate requirements in accordance to self signed JWTs

* Added a new section to summarise all change requests in the release notes

* Added headings

* Added obligation milestones

* Improvement to wording of profile scope data language based on commmunity feedback

* Updated diff

* corrected non-normative examples using the unsupported HS256 alg. Changed examples to PS256 to align with FAPI requirements

* Added 482 descriptions to the release notes

* Updated release notes

* Update dcr OAS so it compiles

* Standards Maintenance Issue #457: Made EnergyServicePointDetail.meters.registers.registerSuffix field optional

* Updated release notes to contain links to the associated change request

* Updated Register swagger to addres empty content fields causing compilation issues

* header requirements for versioned Register APIs moved from mandatory to optional

* Standards Maintenance Issue #438: Added calculationFactors and adjustments objects to EnergyBillingOtherTransaction model

* Added version delta comments

* Rebuild
Fix minor typos in diffs

* Removed debugging output for date picker

* Standards Maintenance Issue #439: Added timezone field to EnergyPlanTariffPeriod

* Fixed compile issues for date picker scripts

* Added Register dependency schedule table to differentiate Register delivery from Participant future dated obligations

* Added requirement for data holders to ignore unsupported authorisation scopes

* Updated endpoint version schedule to 2022-11-15 for register API versions where binding date was subject to ACCC review

* Standards Maintenance Issue #476: Updated EnergyConcession model to cater for variable concessions. Changed RateString to represent generic percentages.

* Standards Maintenance Issue #476: Moved RateString change description to High Level Standards in Release Notes. Move RateString diff in High Level Standards

* Moved change description to API Endpoints sections in Release Notes

* Set retirement dates for outstanding deprecated Register APIs

* Added standards maintenance issue reference to release notes

* Added standards maintenance issue reference to release notes

* New authenticated endpoints only require cdr-register:read as the authorisation scope

* Added clarification that when statuses are not received or recognised from the CDR Register, the ACCC can inform Data Holders of statuses to trust using an alternative mechanism

* Added GetDataHolderBrandsSummary API to expose public details of Data Holder Brands from the CDR Register to public clients

* Standards Maintenance Issue #478: Made EnergyServicePointDetail.meters and EnergyServicePointDetail.meters.registers fields optional and updated their descriptions

* Documented scopes usage for the authenticated Register endpoint versions

* Changed formatting of dependency dates to remove leading zero

* XV header is a required field

* Made SHOULD requirement bold

* Added version-deltas for register scope usage

* Standards Staging Issue #133: Corrected description of 'oldest-date' by removing the word 'days'

* Standards Staging Issue #170: Documentation fix - EnergyServicePointDetail.meters and EnergyServicePointDetail.meters.registers have been converted into arrays

* Standards Maintenance Issue #439: Updated description of EnergyPlanContract.timezone and EnergyPlanTariffPeriod.timezone to specify default values

* Standards Staging Issue #131: Minor edit- clarification added that ServicePointId to be replaced with NMI in path param as well

* Corrected version delta presentation

* Added Get Data Holder Brands Summary to the endpoints table

* Corrected whitespacing in version deltas

* Standards Staging Issue #153: Modified Energy location to be a CommonPhysicalAddress model

* Added support for 404 response code

* Full rebuild

* Add release date
Reorder release notes

* Standards Staging Issue #167: Corrected x-fapi-interaction-id header to be mandatory for Energy SDH APIs

* Fix to force version delta code blocks to break at word boundaries not at overflow

* 404 now only applies when industry is not found

* Cosmetic improvements in the release notes

* Cleaned up version deltas to follow conventions

* Removed reference to the ACCC delivery schedule

* Full rebuild

* Correct change for staging issue 170

Co-authored-by: Hemang Rathod <[email protected]>
Co-authored-by: Ivan Hosgood <[email protected]>
Co-authored-by: Kirkycdr <[email protected]>
Co-authored-by: James Bligh <[email protected]>
Co-authored-by: James Bligh <[email protected]>
Co-authored-by: Mark Verstege <[email protected]>
Co-authored-by: Ivan Hosgood <[email protected]>
@CDR-API-Stream CDR-API-Stream added Status: Decision Made A determination on this decision has been made and removed Status: Feedback Period Closed The feedback period is complete and a final decision is being formulated labels Jul 31, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Category: API A proposal for a decision to be made for the API Standards made Category: CX A proposal for a decision to be made for the User Experience Standards Category: InfoSec Information Security Technical Working Group Decision Proposal Industry: Banking This proposal impacts the banking industry Status: Decision Made A determination on this decision has been made
Projects
None yet
Development

No branches or pull requests

1 participant