Global

Requirements, UML modelling and software documentation

A ready-made course you customise for your organisation, with a live session deck and two surveys. You only add the 7 details that are specific to your organisation.

See the live deckSee the full outline
Try the coursePreview the survey
Length
40 min
Lessons
6 lessons
Frequency
At onboarding of analysts and developers
Last reviewed
21 Oct 2026
User stories and acceptance criteria
What would you do?

A story says "as a user I want a better report"

Try it: this is one of 15 interactive activities in the course.

What's included

Three pieces that work together

Copy once, get everything. Learners prepare on their own, you answer questions live, and the surveys tell you what stuck.

Self-paced course

Short lessons with real workplace scenarios, not walls of text.

  • 6 lessons, about 40 minutes
  • Sorting activity, process, scenario, timeline and quizzes

Live session deck

An AhaSlides presentation to run after the course, in person or online.

  • 10 slides
  • Quiz, poll, ranking, word cloud slides
  • A closing slide for your contacts

Two surveys

Find out what landed, and whether people use it on the job.

  • Post-course feedback, about 2 minutes
  • 30-day check-in
  • Anonymous by default
  • Results feed your next refresher

Learning objectives

At the end of this course, learners can

Each objective and the lesson that covers it.

IDObjectiveSourceWhere it's covered
TO 335.0Achieve ≥ 80% on the final assessment-Whole course
SO 335.1Classify requirements as functional or non-functional and rewrite vague ones so they can be testedISO/IEC/IEEE 29148 [check before build]Whole course
SO 335.2Write a user story with clear acceptance criteriaBest practiceWhole course
SO 335.3Choose a UML diagram (use case, sequence, class, activity) that fits a questionISO/IEC 19501 UML [check before build]Whole course
SO 335.4Record a decision so the next team understands itBest practiceWhole course
SO 335.5Run a short requirements review using the team checklist + your infoOrganisation's documentation standard; BABOK GuideWhole course

Your part: what a template can't do for you

  • Your workplace details: fill in the 7 highlighted fields so the course describes your own policies, contacts and locations.
  • Records: record completion in your own LMS or record system.

Course outline

6 lessons, about 40 minutes

Minutes per lesson are an estimate, shared out by page count.

ContentInteractiveVideoYou customise
1

A requirement that meant two things

3 pages

8 min
Before you beginNoteList
The word "fast"TextImage
What went wrongTimelineQuiz
2

Functional and non-functional requirements

3 pages

8 min
Two kindsTabs
Sort themSorting activity
CheckFlashcardsMatching quiz
3

User stories and acceptance criteria

3 pages

7 min
Story anatomyProcess
Rewrite the storyScenarioQuiz
Criteria checkChecklist
4

UML diagrams that earn their place

3 pages

7 min
Which diagram?Sorting activity
Spot the confusionScenarioQuiz
CheckMulti-select quiz
5

Documenting decisions for the next team

2 pages

5 min
A decision recordTableNoteYour info
Raise it earlyProcessYour infoKey fact
6

Requirements review and final assessment

2 pages

5 min
The review checklistChecklist
PracticeQuizKey factNoteButtonYour info

Live deck and surveys

10 slides to run live, two surveys to close the loop

Pink slides are interactive. Both surveys are anonymous; pink questions are written for this course.

ContentTitle, agenda, "bring a vague requirement
PollHow are acceptance criteria written in your team?
QuizThe page must load in under 2 seconds with 500 users" is… (Non-functional ✔ · Functional · Constraint · Story)
ContentFunctional versus non-functional; the story template
RankingRank these by testability: "fast", "under 2 s at 500 users", "good", "easy", "no data loss on restart
QuizA team uses a class diagram to explain a message flow. Better choice? (Sequence diagram ✔)
Word cloudThe vaguest requirement you have been handed
ScaleHow confident are you rewriting a vague requirement?
Q&AAsk the trainer anything
Content · customiseClosing {{HELP_CONTACT}}, {{COURSE_URL}}, {{SURVEY_2_URL}}
Post-course feedback: 11 questions, about 2 min
  1. Overall rating 5 stars
  2. Relevant, realistic, right length, helpful activities agree/disagree grid
  3. What was most useful? multi-select
  4. Confidence before this course, and now 1-5 scale
  5. Confidence in requirement types · stories · acceptance criteria · UML · decision records grid
  6. How often are requirements clarified after build starts? multiple choice
  7. Which requirement caused rework recently? short text
  8. I can say ‘this requirement is unclear’ without feeling judged. 1-5 scale
  9. One thing we should change or add open text
  10. Would you recommend this course? NPS
30-day check-in
  1. Have you used what you learned since the course? multiple choice
  2. How confident are you today? Compare with day 1 1-5 scale
  3. Do you know where to find the documentation standard and review checklist? yes / no / not sure
  4. A moment where the training helped, or where you weren't sure open text
  5. Which topics should the next refresher focus on? ranking

Results show whether people use the training on the job, not just whether they finished it.

Make it yours

7 fields to fill in, and you're ready

Everything else is done. These are the details only your organisation knows; each one is highlighted inside the course.

  • Link to the documentation standard{{DOCUMENTATION_STANDARD_LINK}}
  • Who to ask for help or to report a concern{{HELP_CONTACT}}
  • Where completion is recorded{{LMS_OR_RECORD_SYSTEM}}
  • Link to the post-course and 30-day survey{{SURVEY_2_URL}}
  • Link to the self-paced course{{COURSE_URL}}
  • List of approved tools and versions{{APPROVED_TOOLS}}
Show all 7 fields
  • Link to the baseline survey{{SURVEY_1_URL}}

FAQ

Common questions

Can I run requirements, UML modelling and software documentation training online?

Yes. The course is self-paced and online, and the live deck lets you add a live session in the room or online.

How often is this training needed?

At onboarding of analysts and developers, and before a documentation standard is adopted.

Who needs this training?

Business analysts, product owners, developers and architects; run by IT delivery and PMO leads with L&D.

What records should I keep?

Record completion in your own LMS or record system, so you can show who finished the course and when.

Can I edit the content?

Yes, everything. Change the wording, swap scenarios for ones from your workplace, add your logo, or remove parts that don't apply.

Related templates

Often taught together

All Engineering practice templates →
Global

Logging, error handling and observability standards for developers

Developers on enterprise platforms and the code reviewers · Engineering practice

35 min
Global

API design and microservices standards: REST, openapi and events

Back-end engineers · Engineering practice

40 min
Global

Software testing, TDD and test automation in practice

Developers · Engineering practice

45 min
Global

Code review, clean code and design patterns

Junior and mid-level developers · Engineering practice

45 min
Last reviewed: 21 October 2026Templates are a starting point, not legal advice.

Ready to run it?

Open the live deck to see how the session runs alongside the course and both surveys.

See the live deck