Chapter 8 Iteration 1 Basics 8 1 Introduction

Chapter 8: Iteration 1 - Basics

8. 1 Introduction o We review here the requirements for first iteration of our case studies. n They are a subset of the requirements as described by the use cases, the vision, and the supplementary specification; n Subsequent iterations will grow these until a full system is implemented; n The current requirements are not complete, they will evolve and benefit from feedback …

8. 2 Planning the Iterations o After the initial inception phase, the most important software requirements have been identified, some of which have been detailed. n Other requirements remain to be discovered; n Most will need further analysis;

o However after the inception phase we must have a basic, documented, set of requirements: n n n These need to be scheduled over the next few development cycles (the elaboration phase); Only the first few cycles need to be scheduled at this stage (a very detailed schedule is not feasible at this point in time due to the fuzziness of the remaining requirements); An iteration must be time-boxed, say between 2 weeks and 8 weeks (why? ) o To decide which requirements should be tackled early in the project we can use the following criteria: n n n Risk : includes both technical complexity and other factors, such as uncertainty of effort or usability. Coverage : implies that all major parts of the system are at least touched on in early iterations, perhaps a "wide and shallow" implementation across many components. Criticality : refers to functions the client considers of high business value.

o We can then rank use cases, and other high-level features, according to these criteria: Rank Requirement (Use Case or Feature) Comment High Process Sale Logging … Scores high on all rankings Pervasive. Hard to add later … Medium Maintain Users … Affects security … Low … … o This ranking should be reviewed after each iteration as new requirements and new insights will influence it: n The schedule needs to be adaptive; o In addition, we will always consider the Start Up use case: to consider all the necessary initialisations in a systematic way.

8. 3. Case Studies: Requirements for Iteration 1 o For the POS: n Implement a basic, key scenario of the Process Sale use case: entering items and receiving a cash payment. n Implement a Start Up use case as necessary to support the initialization needs of the iteration. n Nothing fancy or complex is handled, just a simple happy path scenario, and the design and implementation to support it. n There is no collaboration with external services, such as a tax calculator or product database. n No complex pricing rules are applied. n User Interface Prototyping if not done already (we will not see this)

8. 3. Case Studies: Requirements for Iteration 1 (con’t) o Discussion: n Subsequent iterations will grow on these foundations; n The requirements have been simplified for the first iteration : to fit in a given time-box; n In iterative lifecycle processes (such as the UP, XP, Scrum, and so forth): We start production-quality programming and testing for a subset of the requirements, and we start that development before all the requirements analysis is complete : contrast to a waterfall process. n A use can span more that one iteration : see Figure 8. 1

8. 3. Case Studies: Requirements for Iteration 1 (con’t) Figure 8. 1: Spreading Use Cases

8. 4 From Inception to Elaboration o The inception phase may only last 1 week (typically more) : it is not very long: n It determines basic feasibility, risk, and scope, to decide if the project is worth more serious investigation (Elaboration). o During the Inception phase the following may occur: n n n a short requirements workshop; most actors, goals, and use cases named; most use cases written in brief format; 10 to 20% of the use cases are written in fully dressed detail to improve understanding of the scope and complexity; most influential and risky quality requirements identified; version one of the Vision and Supplementary Specification written;

8. 4 From Inception to Elaboration (con’t) n risk list; o For example, leadership really wants a demo at the POSWorld trade show in Hamburg, in 18 months. But the effort for a demo cannot yet be even roughly estimated until deeper investigation. n technical proof-of-concept prototypes and other investigations to explore the technical feasibility of special requirements; n user interface-oriented prototypes to clarify the vision of functional requirements n recommendations on what components to buy/build/reuse, to be refined in elaboration

n high-level candidate architecture and components proposed o n n This is not a detailed architectural description, and it is not meant to be final or correct. Rather, it is brief speculation to use as a starting point of investigation in elaboration. For example, "A Java client-side application, no application server, Oracle for the database, …" In elaboration, it may be proven worthy, or discovered to be a poor idea and rejected. plan for the first iteration; candidate tools list; o On to the Elaboration phase: n Elaboration is the initial series of iterations during which: o o o n n the core, risky software architecture is programmed and tested the majority of requirements are discovered and stabilized the major risks are mitigated or retired Elaboration often consists of two or more iterations; each iteration is recommended to be between two and six weeks; prefer the shorter versions unless the team size is massive. Each iteration is timeboxed, meaning its end date is fixed. Build the core architecture, resolve the high-risk elements, define most requirements, and estimate the overall schedule and resources.

8. 4 From Inception to Elaboration (con’t) o Key ideas during elaboration: n do short timeboxed risk-driven iterations; n start programming early; n adaptively design, implement, and test the core and risky parts of the architecture; n test early, often, realistically; n adapt based on feedback from tests, users, developers; n write most of the use cases and other requirements in detail, through a series of workshops, once per elaboration iteration; n Treat each iteration during elaboration as a miniproject;

In addition to the artifacts created during inception (and which need to be refined during elaboration) the following artefacts can be created during the iterations of the elaboration phase: Artefact Comment Domain Model This is a visualization of the domain concepts; it is similar to a static information model of the domain entities. Design Model This is the set of diagrams that describes the logical design. This includes software class diagrams, object interaction diagrams, package diagrams, and so forth. Software Architecture Document Summarizes the key architectural issues and their resolution in the design. Data Model This includes the database schemas, and the mapping strategies between object and non-object representations. Storyboards, UI A description of the user interface, paths of navigation, Prototypes, Artwork and so forth.

8. 5 Conclusion o The elaboration phase will start before the specification is complete … n n n The elaboration phase will be followed by a longer Construction phase. During several iterations, the elaboration phase, builds the core architecture, resolves the high-risk elements, defines most requirements, and estimates/refines the overall schedule and resources. The Elaboration phase is not about requirements, nor design, nor coding : it is all of these at once for the most important (possibly simplified) aspects of the project … During Elaboration, feedback will evolve/complete the requirements. We must produce fully-tested, documented, production-grade code