h a l f b a k e r y
Idea vs. Ego
add, search, annotate, link, view, overview, recent, by name, random
news, help, about, links, report a problem
or get an account
DOORS and ComplyPro are great at managing
requirements. Essentially a database and a web interface
to collect together system requirements and link to V&V
But engineers and subject-matter experts are reluctant
use them, because they arent conducive to flowing
And they dont handle images, diagrams
and tables well. So someone (usually the requirements
manager) ends up cutting and pasting word documents
DOORS, and the engineers (from that point forward)
any responsibility for the resulting system requirement
But the advantages of a formal requirements
system are structure and traceability.
I propose a tool that looks like a text-creation
but has implicit structure and prompts the author to link
each paragraph of text. So every paragraph is indexed,
the creator is asked a few questions to categorise the
Also provides a stakeholder-shared discuss to identify
priorities, and better linking to supporting evidence.
And recursive document references (i.e. not just this
document refers to this other document but this other
document refers to this clause here, so if you change it,
will have a knock-on effect
(?) Trivial pursuit
A great way of making money if you are blessed with a good memory for facts. [8th of 7, Oct 01 2019]
Requirements written as patterns. [Frankx, Oct 02 2019]
Last message to Creation
Big finger. I mean light-years big. [Frankx, Oct 02 2019]
Please log in.
If you're not logged in,
you can see what this page
looks like, but you will
not be able to add anything.
Description (displayed with the short name and URL.)
||// the creator is asked a few questions to categorise the text.//
||... to which the reply comes, "WE APOLOGIZE FOR THE INCONVENIENCE" ?
||This is acceptable as long as they aren't Pink or Orange questions ..
on the whole we prefer Green questions.
||//pink or orange//...//green//
||Sorry, I dont understand. Could you explain
||V&V - Verification and Validation. Core principles
for delivering systems well. Did I explain what it
had to do properly and Does it do it
||Something that fell by the wayside when they spec'd the FCS for the 737MAX ... <Collective sniggering/>
||// Could you explain please? //
||We've experimented with using SBVR, a style-guide for writing requirements that is
well suited to machine-reading and information extraction. It's a kind of
bootstrapping vocabulary where you first define the terms you're going to use, in
english, and then, using more english, lay out how they might legally interact with
one another, and what kinds of relationships are acceptable.
||Then, you can run a program to read all the text and generate a glossary, from this
you can retrospectively apply markup to label/link everything together. We're
planning to, once a bit more time presents itself, turn it into an entity graph.
From that graph we ought to be able to extract the main components, demonstrate the
flows, identify dead-ends and so on.
||Once many of the definitions are setup, you plug these into an editor, and turn on
live colouring - like in a code editor - this further guides the business into
writing their specifications in parsable code - but only once a large enough corpus
exists to make that feasible.
||We're nowhere near reaching critical mass, but it feels like it might be a neat way
of solving the documentation problem.
||Neat. Its only a question of database size and
mass until they start writing their own stories.
||[zen_tom] - wow, that sounds really interesting.
Looked up SBVR and the idea is a good one -
defining terms rigorously has got to be a good
start, and extracting into parseable code sounds
||I know there are model-based requirements
frameworks and requirement definition languages,
but so far the problem I have faced is getting
people (engineers and stakeholders) to use
anything other than Word to document
||Have you tried threats, backed up by actual violence ? We recommend it; cheap, and highly effective.
||Yes, Ive even tried actual face-to-face meetings
with chocolate biscuits. Which are remarkably
||This is like a Pattern Language thing [link]. Lots of
people are comfortable with writing words that
describe what they want of a system. Theyre used
to Word and Excel as tools to write those things.
But there are details that could be captured and
documented well, in a structured way, with some
small improvements. Forcing people to use a
formal system is counterproductive- either they
just dont do it, or they farm the task out to the
least-experienced expendable body, who doesnt
understand the details.
||//apologise for the inconvenience//
||GO STCK YOUR HEAD IN A PIG
||... was the Sirius Cybernetics Corporation.
||This [link] is the Creators last message