This seems to me to be the unspoken elephant in the room with Agile projects: how do you prevent them from evolving into chaos?
Let's look at the Agile Manifesto for a moment. Agile desires:
- Early and continuous delivery
- Embracing changing requirements
- Delivering working software frequently
- Developers and business stakeholders working together daily
- Building projects around motivated individuals, giving them the environment and support they need,
and trusting them to get the job done
- Face to face conversation as the primary mode of communication
- Working software as the primary measure of progress
- Sustainable development
- Continuous attention to technical excellence and good design
- Simplicity - Maximizing the work you don't have to do
- At regular intervals, the team reflects on how
to become more effective, then tunes and adjusts
its behavior accordingly
I've highlighted the last four. Why? Because they're the ones that will prevent the project from collapsing under its own weight.
Sustainable development means that you (hopefully) have someone that oversees the overall development process, someone who can steer the ship beyond growing the software a little bit at a time, someone who has an overarching vision of the entire project, someone with a keen knowledge of software architecture, system design, business logic principles and UI ergonomics. An architect, in other words.
The architect is the one that says "I know you asked for this, but if we build this other thing, we can avoid these other three features that are just confusing, and focus on the core requirement." He's the one that gives the team time to reduce technical debt. He's the one that brings an overarching structure and organization to the project. He's the one that calls meetings where the team gets together and asks "How can we do things better?"
And he's the one that maintains the master requirements document.
In the book Mastering the Requirements Process, the authors maintain that there are three kinds of customers, three kinds of software projects: Rabbits, Horses and Elephants. Rabbits are the small software projects that only need informal requirements; you work directly with the customer in small sprints, the scope of the project is reasonably constrained, and the software gets done within a relatively short time frame. Elephants are those mammoth projects that require a lot of up-front planning, a tremendous amount of documentation, and a long time horizon. They are arguably not agile, although you can break them up into smaller projects that can be built using agile.
It's the Horse projects that are somewhat confounding from an agile perspective. They can still be built iteratively, you can still use short sprints, but without some discipline in the requirements gathering and planning processes, they can easily run off the rails. These are the projects that can benefit from a disciplined requirements gathering process, and then careful adaptation and modification of those requirements as the project grows, while still maintaining an overarching vision for the entire project.
From a personal perspective, I work with a small team of about a dozen developers. At any given moment, we might be working on three software projects at the same time, ranging anywhere from a few thousand lines of code to over 100,000. Our customer thinks they are a rabbit, but they're really a horse. The customer is engaged, but not on a daily basis.
By far our weakest area is gathering specific, testable, measurable requirements and managing the customer's expectations relative to project scope. But we're working on that.
Using one or two diagrams depends on what you want to show:
- The behaviour of the whole functionality
- What the system should do when a certain request comes in
For me it seems logical to make one activity diagram of the whole functionality. Then if you feel the need to go into details of what the system does when receiving a certain request, do nr 2 also. Maybe then a sequence diagram would be the apropriate level, as you want to show the request and which entities (e.g. java classes) will participate in processing it. In this case, maybe you could write the code without making a diagram, but as a practice you can make a simple sequence diagram to see the differences between activity and sequence diagram and how they relate. Happy learning! :-)
Best Answer
Become a customer's request when the customer wants the user can authenticate into application.
As a result, in the architecture diagrams and in use cases diagrams, you must consider this.
It becomes a key element even for testing, and QA. In the work-flow of the application, you'll definitely consider cases involving the authentication process (permitted access, user name and password wrong, suspended accounts, and other).