BA704 | Length: 1 day
How many times have you been faced with having to repeatedly revisit requirements before everyone agrees they have something usable? Who has the luxury of this kind of time?
Projects exist to solve business problems. Without effective requirements documentation, everything falls apart.
Business professionals ask, “what does the technical team want from us?”. Developers ask, “why can’t the business tell us what they need so we can give them some options and build or buy something?”. Business analysts ask, “how can I get maximum value from everyone’s very limited available time?”. Back and forth over the wall goes the documentation.
Objectives and Outcomes
This course provides:
- Best practice technical writing principles that can be applied to all requirements documentation.
- Model and requirements type specific communication formats.
Unit 1: The Basics of Technical Writing in English
- How technical writing differs from other types of writing.
- The parts of speech and their place in technical writing.
- The importance and application of voice, person, and tense.
- Foundation principles of document information architecture.
- Applying the rules of structured English to technical writing.
- How to adjust your technical writing for different situations: information transfer, action by the reader, discussion, decision point.
- Diagnosing and correcting twenty-five common requirements documentation errors.
Unit 2: Documenting Requirements
- The enterprise perspective: How senior management views requirements.
- What different people need to know: Scope, granularity, inclusion, and exclusion.
- The importance of quantifying quality in all requirements, including the application of precision, tolerances, acceptable variance, targets, and thresholds.
- The importance of defining all business relationships in terms of specific, visible, and measurable deliverables.
- How to establish solution lifecycle traceability with requirements.
- Special case documentation tips and traps: Formal and informal, diagram level documentation, presentations, meeting agendas as working briefs.
- How to evaluate and choose from options for packaging requirements based on business needs, stakeholder demographics and the nature of your solution provider.
Unit 3: Taxonomy and Model Specific Documentation
- The business case: Starting from why, benefit accrual stream.
- Documentation for: Problem/opportunity analysis, scoping, real world and automated process, data, messages, business rules, decision tables, functional and non-functional requirements, project, and application level documentation.
- Documenting models: Use cases, workflow diagrams (ANSI, UML Activity Diagrams, BPMN), UML protocol state machines.
Offered in partnership with ACHIEVEBLUE™ Corporation. © 2017 All rights reserved.