Agree on, document, and implement process for resolving issues with the metadata and TOC XML written by the BCMS
Context
There needs to be absolute clarity about the acceptance criteria for the BCMS to write XML that is valid against the BITS DTD and compliant against the PMC style checker and faithful in preview to existing TOCs published from the Silverlight CMS for existing content. There also needs to be 1) a process for identifying issues automatically against NCBI supported scripts as soon as possible in the process - see #1643 - and 2) a process for triaging both those errors AND any errors detected by human QA of the previews not meeting the same level of quality as Silverlight generated TOCs.
Proposal
NCBI and Coko will agree on and document a mutually agreed process for handling issues with the metadata and TOC XML written by the BCMS.
Design
Acceptance criteria
-
A process for handling issues with the metadata and TOC XML written by the BCMS will be documented on the Gitlab wiki. -
The process will be implemented successfully as soon as it is documented for triaging new errors.
Definition of ready
-
BCMS User Story / Context has been well defined -
The priority of the user story is specified and agreed -
Digital assets added (design, database scheme, mockups etc if relevant) -
Coko Technical Proposal approved by NCBI -
Testable Acceptance Criteria approved by NCBI -
Estimate of effort to complete (time or points) -
The issue has been broken down into development tasks (if necessary) -
Requirements Clarified -
The product owner and development team agree that the user story is ready for development -
NCBI adds “Dev_Ready”
Definition of done
-
All coding tasks are finished and implemented -
QA approved -
Deployed and tested on “ncbidev” (by Coko team) -
Deployed and tested on “ncbi” (by NCBI team) -
Acceptance Criteria Met
Implementation
Alternative approaches (if applicable)
Scheduling
-
Milestone is linked -
Iteration is linked -
Dependencies: ("None" or list issue numbers if relevant) -
Development estimate is added to issue time tracking