#3715 accepted task

Add Requirements Engineering chapter to RTEMS Software Engineering Handbook

Reported by: Sebastian Huber Owned by: Sebastian Huber
Priority: normal Milestone: 6.1
Component: doc Version: 6
Severity: normal Keywords: qualification
Cc: Blocked By:
Blocking: #3703

Description

The chapter should cover the following topics:

  • Overview and introduction
  • Evaluation of tools for requirements management
  • Selected tool for requirements management
  • Evaluation of data models and formats for the requirements
  • Definition of data model and format actually used for the project (may overlap with tool)
  • Requirements management workflow used in the project
  • Requirements on requirements, e.g. derived from standards such as ECSS-E-ST-10-06C
  • Requirement identifiers used to ensure traceability

Change History (59)

comment:1 Changed on Mar 4, 2019 at 1:10:43 PM by Sebastian Huber

Status: assignedaccepted
Summary: Add Requirements Engineering chaper to RTEMS Software Engineering HandbookAdd Requirements Engineering chapter to RTEMS Software Engineering Handbook

comment:2 Changed on Mar 4, 2019 at 11:02:03 PM by Chris Johns

How does the quality of RTEMS and it's requirements depend on the evaluation and selection of the tools for requirement management? I can understand the quality of the requirements effecting the quality of RTEMS but not the tools used to capture them? Why have the process, ie a sort of log book, in the engineering handbook? I would have expected this document to contain the out come of the discovery process and not the process itself.

I am concerned adding these things just creates a liability for the project. Can an email archive can perform this task?

comment:3 Changed on Mar 4, 2019 at 11:06:15 PM by Joel Sherrill

I agree with Chris. A trade study of requirements tools shouldn't end up in the handbook. Perhaps our requirements for a tool.

  • open source
  • supports format XXX for interchange
  • supports links for requirement derivation
  • ...

comment:4 Changed on Mar 7, 2019 at 7:34:38 AM by Sebastian Huber

Yes, maybe this is not the best place for the tool overview. I though it would be helpful in case someone asks in two years, why did you use this, have you considered that, etc.? Should I add a ticket for the tool selection instead?

comment:5 in reply to:  4 Changed on Mar 7, 2019 at 9:00:27 PM by Chris Johns

Replying to Sebastian Huber:

Yes, maybe this is not the best place for the tool overview. I though it would be helpful in case someone asks in two years, why did you use this, have you considered that, etc.?

A brief rational can be helpful, but the details can be distracting. I feel the simpler and more direct this document is the more effective it will be.

Should I add a ticket for the tool selection instead?

Yes, it can links to mailing lists discussions and attachments and it is easy to link too.

comment:6 Changed on Jan 7, 2020 at 9:14:04 AM by Sebastian Huber <sebastian.huber@…>

In d412c5b/rtems-docs:

eng: Add Software Requirements Engineering chapter

Update #3715.

comment:7 Changed on Apr 2, 2020 at 7:47:16 AM by Sebastian Huber <sebastian.huber@…>

In 6f0bc56/rtems-docs:

eng: Add glossary terms

Define the following terms:

  • assembler language
  • C language
  • ELF
  • interrupt service
  • software component
  • software unit

Clarify:

  • task

Update #3715.

comment:8 Changed on May 5, 2020 at 5:37:31 AM by Sebastian Huber <sebastian.huber@…>

In d4ba908/rtems-docs:

eng: Update requirements engineering chapter

Update requirements engineering chapter due to the removal of Doorstop
as the requirements management tool.

Update the application configuration related specification items.

Update #3715.

comment:9 Changed on Jun 1, 2020 at 11:02:31 AM by Sebastian Huber <sebastian.huber@…>

In 59312aa/rtems-docs:

eng: Split up requirements engineering chapter

This allows to more easily generate the specification item section with
a script using specification items.

Update #3715.

comment:10 Changed on Jun 1, 2020 at 11:02:33 AM by Sebastian Huber <sebastian.huber@…>

In 23ab40d/rtems-docs:

eng: Add generated documentation of spec items

The documentation of the specification items is generated by an RTEMS
qualification tool from a specification of specification items.

Move non-generated content to "req-for-req.rst".

Update #3715.

comment:11 Changed on Jun 1, 2020 at 11:02:35 AM by Sebastian Huber <sebastian.huber@…>

In 459326c/rtems-docs:

eng: Update requirements tooling section

Update #3715.

comment:12 Changed on Jun 1, 2020 at 11:02:37 AM by Sebastian Huber <sebastian.huber@…>

In 9b269ad/rtems-docs:

eng: Add interface specification how-to

Update #3715.

comment:13 Changed on Jun 8, 2020 at 7:05:29 AM by Sebastian Huber <sebastian.huber@…>

In f547988/rtems-docs:

eng: Simplify wording for specification items

Update #3715.

comment:14 Changed on Jun 8, 2020 at 7:05:31 AM by Sebastian Huber <sebastian.huber@…>

In 0c43c52/rtems-docs:

eng: Add generic attribute key types

Update #3715.

comment:15 Changed on Jun 8, 2020 at 7:05:33 AM by Sebastian Huber <sebastian.huber@…>

In 0213e8e/rtems-docs:

eng: Add a specification type for actions

Add support to specify functional requirements for actions (functions or
macros) via a transition map of pre-conditions to post-conditions. This
will be the work horse for functional requirements. Generation of
corresponding validation tests is supported.

Update #3715.

comment:16 Changed on Jun 8, 2020 at 7:05:35 AM by Sebastian Huber <sebastian.huber@…>

In ca2f5e6/rtems-docs:

eng: Update specification how-to section

Update #3715.

comment:17 Changed on Jun 10, 2020 at 8:12:37 AM by Sebastian Huber <sebastian.huber@…>

In db3892b/rtems-docs:

eng: Update action requirement specification

Update #3715.

comment:18 Changed on Jun 17, 2020 at 7:11:35 AM by Sebastian Huber <sebastian.huber@…>

In 87a9478/rtems-docs:

eng: Clarify action requirement specification

Update #3715.

comment:19 Changed on Jul 3, 2020 at 8:34:03 AM by Sebastian Huber <sebastian.huber@…>

In 1bd14cd/rtems-docs:

eng: Reformat to maximize the text width

Remove extra "X" character in some labels.

Update #3715.

comment:20 Changed on Jul 3, 2020 at 8:34:05 AM by Sebastian Huber <sebastian.huber@…>

In 0c13e94/rtems-docs:

eng: Fix typo

Update #3715.

comment:21 Changed on Jul 28, 2020 at 5:33:52 AM by Sebastian Huber <sebastian.huber@…>

In fd2fc50/rtems-docs:

eng: Add requirement text to interface groups

This allows to state the requirement for an interface group directly in
the item.

Update #3715.

comment:22 Changed on Jul 28, 2020 at 5:33:54 AM by Sebastian Huber <sebastian.huber@…>

In f12cae1/rtems-docs:

eng: Add brief description to header file items

Update #3715.

comment:23 Changed on Jul 28, 2020 at 5:33:56 AM by Sebastian Huber <sebastian.huber@…>

In c259563/rtems-docs:

eng: Support N/A in the action transitions

Sometimes the pre-conditions in an action requirement are not
independent and it is necessary to mark pre-conditions as not applicable
in a particular transition.

Update #3715.

comment:24 Changed on Jul 28, 2020 at 5:33:58 AM by Sebastian Huber <sebastian.huber@…>

In 3f9fa47/rtems-docs:

eng: Add ability to skip action transitions

Sometimes the pre-conditions in an action requirement are not
independent and it is necessary skip a certain set of pre-condition
states. This should be used with care since no test code is run in
these cases. There shall be a reason given why skipping a transition is
justified.

Update #3715.

comment:25 Changed on Jul 28, 2020 at 5:34:01 AM by Sebastian Huber <sebastian.huber@…>

In 1bb6947/rtems-docs:

eng: Fix format of regular expressions

Update #3715.

comment:26 Changed on Aug 6, 2020 at 7:12:00 AM by Sebastian Huber <sebastian.huber@…>

In bac4398/rtems-docs:

eng: Fix typo

Update #3715.

comment:27 Changed on Aug 6, 2020 at 7:18:47 AM by Sebastian Huber <sebastian.huber@…>

In e1e0408/rtems-docs:

eng: Partially revert previous commit

The previous commit contained more than just a typo fix. Remove this
part.

Update #3715.

comment:28 Changed on Aug 7, 2020 at 4:44:14 AM by Sebastian Huber <sebastian.huber@…>

In 83e13b7/rtems-docs:

eng: Add application config options how-to

Update #3715.

comment:29 Changed on Aug 7, 2020 at 5:15:28 AM by Sebastian Huber <sebastian.huber@…>

In 3e8e301/rtems-docs:

eng: Add more variants of unspecified interfaces

Update #3715.

comment:30 Changed on Aug 7, 2020 at 5:15:31 AM by Sebastian Huber <sebastian.huber@…>

In 5cb493e/rtems-docs:

eng: Add reference to unspecified interfaces

Update #3715.

comment:31 Changed on Aug 20, 2020 at 7:01:23 AM by Sebastian Huber <sebastian.huber@…>

In 9633e98/rtems-docs:

eng: Add test case attributes

Update #3715.

comment:32 Changed on Aug 20, 2020 at 7:01:25 AM by Sebastian Huber <sebastian.huber@…>

In 1a48655/rtems-docs:

eng: Remove test name attribute

Derive the test name from the item UID.

Update #3715.

comment:33 Changed on Aug 20, 2020 at 7:01:27 AM by Sebastian Huber <sebastian.huber@…>

In 83a3522/rtems-docs:

eng: Add test header to test case

Update #3715.

comment:34 Changed on Aug 20, 2020 at 7:01:29 AM by Sebastian Huber <sebastian.huber@…>

In 93938c7/rtems-docs:

eng: Unify test attribute keys

Update #3715.

comment:35 Changed on Aug 20, 2020 at 7:01:32 AM by Sebastian Huber <sebastian.huber@…>

In 57fb30d/rtems-docs:

eng: Add automatically generated warning

Update #3715.

comment:36 Changed on Oct 11, 2020 at 1:20:43 PM by Sebastian Huber <sebastian.huber@…>

In c18215c/rtems-docs:

eng: Move index-entries to all interfaces

Update #3715.

comment:37 Changed on Oct 11, 2020 at 1:20:45 PM by Sebastian Huber <sebastian.huber@…>

In bcf4a95/rtems-docs:

eng: Add placement link role

Update #3715.

comment:38 Changed on Oct 24, 2020 at 10:15:38 AM by Sebastian Huber <sebastian.huber@…>

In abc9c44/rtems-docs:

eng: Replace spec2doc.py with spec2modules.py

Update #3715.

comment:39 Changed on Nov 9, 2020 at 2:05:33 PM by Sebastian Huber <sebastian.huber@…>

In f610291/rtems-docs:

eng: Add function attributes

Update #3715.

comment:40 Changed on Nov 19, 2020 at 10:24:36 AM by Sebastian Huber <sebastian.huber@…>

In bbd8d4a/rtems-docs:

eng: Fix typo

Update #3715.

comment:41 Changed on Nov 27, 2020 at 8:17:00 AM by Sebastian Huber <sebastian.huber@…>

In 4b03ff7/rtems-docs:

eng: Add performance specification items

Add items to specify runtime performance requirements.

Update #3715.

comment:42 Changed on Jan 15, 2021 at 5:40:59 AM by Sebastian Huber <sebastian.huber@…>

In a08e672/rtems-docs:

eng: Add design group requirement item type

Update #3715.

comment:43 Changed on Feb 8, 2021 at 2:02:53 PM by Sebastian Huber <sebastian.huber@…>

In 174444f/rtems-docs:

eng: Update test case item

Update #3715.

comment:44 Changed on Mar 2, 2021 at 7:29:25 AM by Sebastian Huber <sebastian.huber@…>

In fcac22e/rtems-docs:

eng: Fix typo

Update #3715.

comment:45 Changed on Mar 8, 2021 at 7:29:24 AM by Sebastian Huber <sebastian.huber@…>

In a4b3019/rtems-docs:

eng: Add how-to for action requirements

Update #3715.

comment:46 Changed on Mar 8, 2021 at 9:19:49 AM by Sebastian Huber <sebastian.huber@…>

In e05df28/rtems-docs:

eng: Clarify how-to for action requirements

Update #3715.

comment:47 Changed on Mar 11, 2021 at 5:57:22 AM by Sebastian Huber <sebastian.huber@…>

In 0518d94/rtems-docs:

eng: Clarify how-to for action requirements

Update #3715.

comment:48 Changed on Mar 11, 2021 at 6:54:01 AM by Sebastian Huber <sebastian.huber@…>

In bc0a857/rtems-docs:

eng: Clarify how-to for action requirements

Bring how-to in line with current action requirements.

Update #3715.

comment:49 Changed on Mar 19, 2021 at 7:20:33 AM by Sebastian Huber <sebastian.huber@…>

In 239644b/rtems-docs:

eng: Update EARS syntax

The document used the EARS syntax from 2009 which slightly changed in
2016, see "Listens Learned (8 Lessons Learned Applying EARS)". The
optional pre-conditions moved to the state-driven pattern. This refined
syntax fits better to the action requirements.

Update #3715.

comment:50 Changed on Mar 19, 2021 at 7:20:35 AM by Sebastian Huber <sebastian.huber@…>

In b580a6d/rtems-docs:

eng: Add build/appl config clauses to how-to

Update #3715.

comment:51 Changed on Mar 19, 2021 at 7:20:37 AM by Sebastian Huber <sebastian.huber@…>

In b40e043/rtems-docs:

eng: Document expressions in action requirements

Update #3715.

comment:52 Changed on Mar 19, 2021 at 7:20:40 AM by Sebastian Huber <sebastian.huber@…>

In 4476290/rtems-docs:

eng: Add example to action requirements how-to

Update #3715.

comment:53 Changed on Apr 27, 2021 at 7:46:36 AM by Sebastian Huber <sebastian.huber@…>

In 3fa9ed4/rtems-docs:

eng: Allow multiple interface references

Update #3715.

comment:54 Changed on Apr 29, 2021 at 5:31:36 AM by Sebastian Huber <sebastian.huber@…>

In 889a5ff/rtems-docs:

eng: Remove embedded constraints

Update #3715.

comment:55 Changed on Apr 29, 2021 at 5:31:39 AM by Sebastian Huber <sebastian.huber@…>

In e263e84/rtems-docs:

eng: Add unit test link role

Update #3715.

comment:56 Changed on Apr 29, 2021 at 9:05:21 AM by Sebastian Huber <sebastian.huber@…>

In b6cb057/rtems-docs:

eng: Remove scope from constraints

Use links instead of this special purpose attributes.

Update #3715.

comment:57 Changed on Apr 29, 2021 at 9:05:24 AM by Sebastian Huber <sebastian.huber@…>

In a95c968/rtems-docs:

eng: Add test suite name

Update #3715.

comment:58 Changed on Apr 30, 2021 at 5:06:27 AM by Sebastian Huber <sebastian.huber@…>

In aa0c495/rtems-docs:

eng: Remove text attribute from acfg options

Update #3715.

comment:59 Changed on May 8, 2021 at 8:27:49 AM by Sebastian Huber <sebastian.huber@…>

In b797009/rtems-docs:

eng: Add unspecified interface groups

Update #3715.

Note: See TracTickets for help on using tickets.