search

asam-ev / asam-project-guide

(WIP!) Project Guide for ASAM OpenX standards
Mozilla Public License 2.0
2 stars 0 forks source link

Content feedback: Project Participant is described imprecise #107

Closed Marius-ASAM closed 1 year ago

Marius-ASAM commented 2 years ago

Prerequisites

This is in regards to:

Subject

Unspecific language

Section

Roles Description table / Project Participant

Description

"consists of many different ..." is unprecise

Suggestion

Either write "Each project consists of Project Participants who..." or be specific "Each project consists of three or more Project Participants who" - I don't know if "three" is the correct number, therefore please pick the one that is correct if you opt for this version
URL https://asam-ev.github.io/asam-project-guide/asamprojectguide/latest/concepts/roles-overview.html
Page Roles Overview
Module concepts
philipwindecker commented 2 years ago

I believe that three is correct. Alternatively, we could also substitude "many different" with "multiple" to emphasize the fact that there is more than one Participant in each project without defining a specific number. That way, if the requirement changes sometime down the road, "three" does not have to be replaced all over the Project Guide but only where it is specifically and intentionally used (e.g. in the extended phase description).

I personally would opt for the more generic approach here. What would your preference be, @Marius-ASAM?