[tsc-general][acumosaicommunity][architecture][acumosaidevdiscuss] How to proceed with new functionality use cases?
Aimee Ukasick <aimeeu.opensource@...>
Hi all - use cases for new platform functionality are emerging, so
how do we proceed with use case review, architectural review, and,
if needed, TSC approval?
The TSC already approved the subcommittees, but I hope we don't have to wait for an official Subcommittee Chair role before we, the Community, can organize subcommittee meetings and start discussing new use cases. Specifically, the authors of the Authorship Management use case would like community discussion: Requirements
Developers who have been working on the seed code have already mapped out proposed solutions and the work required. They would like to bring this needed use case to the Community but are unsure how/where to begin. Thoughts, suggestions? Thanks! -- Aimee Ukasick irc: aimeeu |
|
SULLIVAN, BRYAN L (BRYAN L) <bryan.sullivan@...>
We need the Architecture and Product committee to form and take responsibility for such efforts. That is the key critical path dependency to avoid organizational chaos.
In the meantime we need to move all offline design processes and sprint/release planning into public view through the wiki, etherpad, etc.
Once the committees have formed, I recommend we apply this process for new feature planning: 1) The goal of an enhancement is brought before the Product committee in Acumos, and documented as use cases on the page https://wiki.acumos.org/display/ACCOM/Product+Committee. 2) The use cases are discussed and approved by the Product committee and handed off to the Architecture committee for design and implementation planning. 3) The Architecture committee creates a high-level design that is documented on / referenced from the wiki at https://wiki.acumos.org/display/AR/Architecture+Home. Documents support any details beyond a high level description of the implementation impacts to Acumos components, and include diagrams, data flows, etc as needed to ensure the technical implementation details are clear, complete, accurate. 4) The Architecture committee agrees with the Product committee oversight, that the detailed design meets the goals of the use case. 5) The design is entered into JIRA as epics etc and the work proceeds in sprints.
A modification of the above is where a design issue or major bug is first discussed in the Architecture committee and referred to the Product committee once the Architecture committee has generally agreed on a high-level approach to implementing a solution. The Product committee needs to consider the impact (of delaying implementation) vs effort of implementing, in their release planning.
Thanks, Bryan Sullivan | AT&T
From: tscgeneral@... [mailto:tscgeneral@...]
On Behalf Of Aimee Ukasick
Sent: Tuesday, April 24, 2018 9:21 AM To: tscgeneral@...; 'acumosaidevdiscuss@...' <acumosaidevdiscuss@...>; acumosaicommunity@...; architecture@... Subject: [tscgeneral] [tsc-general][acumosaicommunity][architecture][acumosaidevdiscuss] How to proceed with new functionality use cases?
Hi all - use cases for new platform functionality are emerging, so how do we proceed with use case review, architectural review, and, if needed, TSC approval? Requirements
-- Aimee Ukasick irc: aimeeu |
|
SULLIVAN, BRYAN L (BRYAN L) <bryan.sullivan@...>
To help us get to a clearer understanding and consensus on the roles of the Architecture and Product committees, I added some info on “Process” to the wiki pages below, described from the view of each committee. Once we create an overall Acumos development process document, e.g. as an addendum to the draft community roles/process document that Aimee contributed, we can create a single overall view of this process. But for now, please read the following wiki pages and comment: https://wiki.acumos.org/display/AR/Architecture+Home https://wiki.acumos.org/display/ACCOM
Thanks, Bryan Sullivan | AT&T
From: SULLIVAN, BRYAN L (BRYAN L)
Sent: Tuesday, April 24, 2018 9:29 AM To: tscgeneral@...; 'acumosaidevdiscuss@...' <acumosaidevdiscuss@...>; acumosaicommunity@...; architecture@... Subject: RE: [tscgeneral] [tsc-general][acumosaicommunity][architecture][acumosaidevdiscuss] How to proceed with new functionality use cases?
We need the Architecture and Product committee to form and take responsibility for such efforts. That is the key critical path dependency to avoid organizational chaos.
In the meantime we need to move all offline design processes and sprint/release planning into public view through the wiki, etherpad, etc.
Once the committees have formed, I recommend we apply this process for new feature planning: 1) The goal of an enhancement is brought before the Product committee in Acumos, and documented as use cases on the page https://wiki.acumos.org/display/ACCOM/Product+Committee. 2) The use cases are discussed and approved by the Product committee and handed off to the Architecture committee for design and implementation planning. 3) The Architecture committee creates a high-level design that is documented on / referenced from the wiki at https://wiki.acumos.org/display/AR/Architecture+Home. Documents support any details beyond a high level description of the implementation impacts to Acumos components, and include diagrams, data flows, etc as needed to ensure the technical implementation details are clear, complete, accurate. 4) The Architecture committee agrees with the Product committee oversight, that the detailed design meets the goals of the use case. 5) The design is entered into JIRA as epics etc and the work proceeds in sprints.
A modification of the above is where a design issue or major bug is first discussed in the Architecture committee and referred to the Product committee once the Architecture committee has generally agreed on a high-level approach to implementing a solution. The Product committee needs to consider the impact (of delaying implementation) vs effort of implementing, in their release planning.
Thanks, Bryan Sullivan | AT&T
From:
tscgeneral@... [mailto:tscgeneral@...]
On Behalf Of Aimee Ukasick
Hi all - use cases for new platform functionality are emerging, so how do we proceed with use case review, architectural review, and, if needed, TSC approval? Requirements
-- Aimee Ukasick irc: aimeeu |
|