camaraproject / IdentityAndConsentManagement

Repository to describe, develop, document and test the Identity And Consent Management for CAMARA APIs
Apache License 2.0
18 stars 30 forks source link

The wording in the Mandatory template for info.description is unclear #178

Open RandyLevensalor opened 5 days ago

RandyLevensalor commented 5 days ago

Problem description

The wording in the Mandatory template for info.description is unclear.

Which specific authorization flows are to be used will be determined during onboarding process, happening between the API Client and the Telco Operator exposing the API, taking into account the declared purpose for accessing the API, while also being subject to the prevailing legal framework dictated by local legislation.

Expected behavior At a minimum add a the before onboarding process or use the plural onboarding processes if that was the intent.

- during onboarding process
+ during the onboarding process

Alternative solution

Alternately, split this into two sentences.

"The specific authorization flows to be used will be determined during the onboarding process between the API client and the Telco operator exposing the API. This determination will consider the declared purpose for accessing the API and be subject to the prevailing legal framework dictated by local legislation."

Additional context

We've added this Mandatory text to QoD and it isn't clear.

I'm happy to create a PR and discuss further.