88 Commits

Author SHA1 Message Date
Sebastian Huber
1a4865512e eng: Remove test name attribute
Derive the test name from the item UID.

Update #3715.
2020-08-19 11:11:45 +02:00
Sebastian Huber
9633e98d5d eng: Add test case attributes
Update #3715.
2020-08-19 11:11:45 +02:00
Sebastian Huber
7811c76135 eng: Add Doxyfile update to release process 2020-08-10 11:41:08 +02:00
Sebastian Huber
5cb493eeb1 eng: Add reference to unspecified interfaces
Update #3715.
2020-08-07 07:15:09 +02:00
Sebastian Huber
3e8e301b06 eng: Add more variants of unspecified interfaces
Update #3715.
2020-08-07 07:15:09 +02:00
Sebastian Huber
83e13b70e2 eng: Add application config options how-to
Update #3715.
2020-08-07 06:43:57 +02:00
Sebastian Huber
e2abac7f30 eng: Refer to the rtems-central repository
Close #4043.
2020-08-07 06:43:29 +02:00
Sebastian Huber
e1e04083e3 eng: Partially revert previous commit
The previous commit contained more than just a typo fix.  Remove this
part.

Update #3715.
2020-08-06 09:16:55 +02:00
Sebastian Huber
bac4398afc eng: Fix typo
Update #3715.
2020-08-06 09:11:39 +02:00
Christian Mauderer
5bd15a0a05 eng/release: Add libbsd version update 2020-07-29 11:13:34 +02:00
Sebastian Huber
1bb694719f eng: Fix format of regular expressions
Update #3715.
2020-07-28 07:33:18 +02:00
Sebastian Huber
3f9fa47dc0 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.
2020-07-28 07:33:18 +02:00
Sebastian Huber
c2595631da 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.
2020-07-28 07:33:18 +02:00
Sebastian Huber
f12cae140e eng: Add brief description to header file items
Update #3715.
2020-07-28 07:33:18 +02:00
Sebastian Huber
fd2fc509a3 eng: Add requirement text to interface groups
This allows to state the requirement for an interface group directly in
the item.

Update #3715.
2020-07-28 07:33:18 +02:00
Sebastian Huber
ba3f26561a eng: Add recommendations for attributes
Fix formatting.
2020-07-24 07:10:51 +02:00
Sebastian Huber
21fa28c7ad eng: Update test framework chapter
Document the dynamic text fixtures, utility functions, and the interrupt
test support.  Reorder some sections and reword some paragraphs based on
review comments.

Update #3199.
2020-07-23 10:04:59 +02:00
G S Niteesh Babu
b82e7d6730 eng: fix typo in coding-file-hdr.rst 2020-07-11 20:50:17 +02:00
Sebastian Huber
0c13e946d0 eng: Fix typo
Update #3715.
2020-07-03 10:33:30 +02:00
Sebastian Huber
1bd14cda60 eng: Reformat to maximize the text width
Remove extra "X" character in some labels.

Update #3715.
2020-07-03 10:33:25 +02:00
Sebastian Huber
d07eecaaf7 eng: Update release process 2020-06-30 09:39:56 +02:00
Chris Johns
06a8f1059b eng: Update the release procedure. 2020-06-26 15:16:13 +10:00
Sebastian Huber
87a9478da6 eng: Clarify action requirement specification
Update #3715.
2020-06-17 09:10:52 +02:00
Sebastian Huber
db3892b5b8 eng: Update action requirement specification
Update #3715.
2020-06-10 10:12:00 +02:00
Sebastian Huber
ca2f5e6384 eng: Update specification how-to section
Update #3715.
2020-06-08 08:53:02 +02:00
Sebastian Huber
0213e8efab 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.
2020-06-08 08:52:50 +02:00
Sebastian Huber
0c43c520c8 eng: Add generic attribute key types
Update #3715.
2020-06-04 15:06:12 +02:00
Sebastian Huber
f54798854f eng: Simplify wording for specification items
Update #3715.
2020-06-04 15:06:12 +02:00
Sebastian Huber
b35f3ef44a Use a complete sentence for acronym definitions 2020-06-04 15:06:12 +02:00
Sebastian Huber
9b269adc6c eng: Add interface specification how-to
Update #3715.
2020-06-01 13:00:41 +02:00
Sebastian Huber
459326c2b9 eng: Update requirements tooling section
Update #3715.
2020-05-29 17:47:21 +02:00
Sebastian Huber
23ab40d3e6 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.
2020-05-29 08:21:03 +02:00
Sebastian Huber
59312aa965 eng: Split up requirements engineering chapter
This allows to more easily generate the specification item section with
a script using specification items.

Update #3715.
2020-05-29 07:14:53 +02:00
Sebastian Huber
d4ba908e42 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.
2020-05-05 07:03:40 +02:00
Joel Sherrill
2d22d7453d Rework RTEMS licensing discussions.
This now captures historical rationale along with cross-linking
code templates with license guidelines.

Closes #3962.
2020-05-01 11:11:31 -05:00
Sebastian Huber
7e08133aff eng: Adjust config.h include
Use variant used by most source files.
2020-04-15 16:50:35 +02:00
Chris Johns
ec9457f604 Add a release procedure section. 2020-04-04 10:14:11 +11:00
Sebastian Huber
2c7cd341a0 eng: Add documentation guidelines
Start with templates for the application configuration options.

Remove "Format to be followed for making changes in this file" from
c-user.

Update #3910.
2020-04-02 10:23:36 +02:00
Sebastian Huber
6f0bc56893 eng: Add glossary terms
Define the following terms:

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

Clarify:

* task

Update #3715.
2020-04-01 07:49:15 +02:00
Sebastian Huber
aceadb15d6 eng: Add Python development guidelines 2020-03-19 07:41:30 +01:00
Sebastian Huber
7d05a3d801 eng: Add glossary
Update #3853.
2020-03-02 08:11:42 +01:00
Sebastian Huber
ca1a9e6677 eng: Fix typo 2020-02-25 12:43:18 +01:00
Sebastian Huber
d27e6304d0 eng: Rework file template section
Update #3053.
2020-02-24 08:13:54 +01:00
Sebastian Huber
76b3aead1b eng: Grammar fix
Update #3199.
2020-02-10 13:48:49 +01:00
Sebastian Huber
b6c61e38ab eng: Mention test framework buffer configuration
Update #3199.
2020-02-10 07:36:01 +01:00
Sebastian Huber
45a0f65798 eng: Document test framework formatted output
Update #3199.
2020-02-10 07:35:58 +01:00
Sebastian Huber
d9d9c700a2 Revert "common: Add URLs to manuals"
This reverts commit 1fdd3cf83d154af66ad0edf5094d93075063c7e0 and some
follow up changes.
2020-02-04 05:45:02 +01:00
Sebastian Huber
d412c5bf2a eng: Add Software Requirements Engineering chapter
Update #3715.
2020-01-07 07:45:49 +01:00
Sebastian Huber
1ff876aa59 eng: Rework stakeholder chapter 2020-01-07 07:20:19 +01:00
Sebastian Huber
b44feffacb eng: Rework preface and add mission statement
Add mission statement based on the wiki page:

https://devel.rtems.org/wiki/Mission_Statement

Do format changes and some rewording.
2020-01-07 07:19:50 +01:00