Per the action item above, we review the changes to sections 2, 3, and the new section 4 in Working Draft #2 of the ToIP Technical Architecture Spec. Note that section numbers have now been updated throughout the spec to reflect that one new section was added.
- Specific comments on the revisions in sections 2, 3, and 4 were recorded as comments in the Google doc.
- Vladimir Simjanoski felt these sections were definitely an improvement over the previous text.
- We agreed to add references to the two other deliverables to which this TF has committed.
- DECISION: We will mark each main section of the spec as informative or normative (as is done with specs from W3C and others).
- There was a general consensus that the revised Motivations section incorporated previous comments.
- There was some discussion about the name of this section. Drummond Reed explained that "Motivations" was frequently used with IETF RFCs.
- ACTION: Wenjing Chu will add an additional bullet point to the Motivations section regarding "minimal design", "simplicity", or "spanning layers".
- We discussed the new separate Use Cases section (section 5). Comments have been added to the Google doc. In addition:
- Daniel Bachenheimer suggested that it would be good to have more nuanced examples... not just a driving license but what other authorizations? commercial? organ donor? similar for financial - KYC may be multiple factors; some of which can be re-used - some not
- Vlad Zubenko suggested including a use case about educational credentials - score reports, job skills etc.
- ACTION: Vlad Zubenko to add a use case about educational credentials to the table in section 5.
- ACTION: Darrell O'Donnell to revisit the use case table and propose a different set of use cases (Neil Thomson suggests a maximum of 12 that are as different as possible).
- Neil Thomson suggested: "Time to spin up one or more docs on Use Cases of two types - Business (for policy makers/public) and (deep) Technical, then pull back "representative" sample Use Cases back to this spec."
- We also discussed adding links for defined terms to their definitions in a ToIP glossary, which Drummond has already started to do.
- ACTION: Neil Thomson asked contributors & reviewers to flag words/terms/concepts that need a definition in the terms wiki with a comment "needs term defn".
APAC:
- We discussed the structure of the remaining sections and came to consensus that it would be easier to write and read if .
- DECISION: We will not separate out requirements into separate sections organized by layer, rather we will restructure sections 6 and higher to incorporate requirements "inline".
- ACTION: Drummond Reed to implement the editorial revisions and restructuring reflected in the decisions above.
- ACTION: Wenjing Chu, Drummond Reed and Darrell O'Donnell to either close or move to GitHub as many issues as possible before next week's meeting.