A most basic Requirement with a 'name', an 'id', and 'text'

Click on the image to view it full size
Dr Darren says:
"It's important when teaching real Requirements Engineering to real engineers to use really real examples from real world projects, so I've chosen one here from the mockumentary film 'This is Spinal Tap'.
From Wikipedia:
'"Up to eleven", also phrased as "these go to eleven", is an idiom from popular culture, coined in the 1984 movie This Is Spinal Tap, where guitarist Nigel Tufnel proudly demonstrates an amplifier whose volume knobs are marked from zero to eleven, instead of the usual zero to ten.'

Before jumping straight in and using that 'text' field on all of your Requirements, please consider this recommendation:

The reality is, the Requirements system in SysML works brilliantly together with model-based engineering (other technologies don't) and the tool support for it is excellent.

You can't callout the 'text' of a Requirement into the compartments for the relevant relationships anyway (and you don't even really need it in query tables if you use a verbose 'name').

If you use a verbose 'name' and a long 'text' sooner or later it will break, because it is WET not DRY.

But if you use a short Requirement 'name' and a long 'text', the short 'name' won't be useful enough in callouts or even as a mental prod as soon as you have lots of requirements on a real project. So you might as well just use no 'text' at all if you can get away with it.

One possibly good excuse for rejecting this recommendation here is that you wish to use this nice feature of MagicDraw SysML Plugin and Magic Cyber-Systems Engineer ® (Cameo Systems Modeler®): But you'll need to check them anyway, the language and maths parsing is pretty good, but not perfect.

And just in case you are tempted to "document" your requirements:

So, with all necessary caveats concerning the 'text' field behind us, the rest of this tutorial trail will in fact use the 'text' field anyway. We'll see next that the 'text' in fact lives in the AbstractRequirement along with some other essential requirements engineering goodies.

Up next
Snippets (quotes/extracts)
Visit also
Visit also (backlinks)
Related slides (includes other tutorials)
Related slides (backlinks, includes other tutorials)