[docs] eng: Use a recommendation for requirement texts

Gedare Bloom gedare at rtems.org
Mon Jan 23 15:20:57 UTC 2023


On Sun, Jan 22, 2023 at 11:58 PM Sebastian Huber
<sebastian.huber at embedded-brains.de> wrote:
>
> On 20.01.23 23:55, Gedare Bloom wrote:
> > I understand this change. I wonder if there are some terms that you
> > definitely want to avoid though?
> >
> > Do you have tooling to warn on the use of these terms in requirements?
> > If not, that could be something easy for a student to put together as
> > a beginner/janitor task.
>
> This change is related to:
>
> https://github.com/RTEMS/rtems-central/commit/28cee60d99535c27e4bad0c87b13aa67de931c7a
>
> The string assertion statement simply checked if the given phrases were
> contained in the text. This resulted in too many false positives. It
> would be a nice project to check that requirement texts are in EARS
> format. This probably requires the use of trained software and some
> natural language processing tools.
>
Got it, thanks. Yes, that is an interesting problem. Seems like
someone could have solved it elsewhere already too. Could be a
suitable student project.

> --
> embedded brains GmbH
> Herr Sebastian HUBER
> Dornierstr. 4
> 82178 Puchheim
> Germany
> email: sebastian.huber at embedded-brains.de
> phone: +49-89-18 94 741 - 16
> fax:   +49-89-18 94 741 - 08
>
> Registergericht: Amtsgericht München
> Registernummer: HRB 157899
> Vertretungsberechtigte Geschäftsführer: Peter Rasmussen, Thomas Dörfler
> Unsere Datenschutzerklärung finden Sie hier:
> https://embedded-brains.de/datenschutzerklaerung/


More information about the devel mailing list