Baseline - Introduction - feedback

[gmuratk]

Problem description
Several text edit suggestions on Baseline doc PR #13 Introduction section

Expected action

1. ‘Operator platform’ may unintentionally refer to GSMAs “Operator Platform Group” and reader implying a specific implementation (i.e. Open Gateway). In alignment with the architectural diagram, we can use “Exposure Gateway” instead.
2. "This means that an API...” instead we can be specific a “CAMARA API exposed to Capability Consumers.”
3. “Policy enforcement … access to a (set of) scopes” -- until this part Personal Information is used and there is no linkage to scope. We can help reader if we put ‘Personal Information (PI) resources that are referred to as scope’.

Additional context
n/a

[jpengar]

‘Operator platform’ may unintentionally refer to GSMAs “Operator Platform Group” and reader implying a specific implementation (i.e. Open Gateway). In alignment with the architectural diagram, we can use “Exposure Gateway” instead.

We originally included the term "Operator NaaS Platform" and were asked to change it to "Operator Platform" (#17). We are happy to change it to "Exposure Gateway" or something else, but we should all agree on the right term to move forward.

"This means that an API...” instead we can be specific a “CAMARA API exposed to Capability Consumers.”

Fine, we can review the content of the document to apply this change. Feel free to suggest this kind of specific change directly on the PR itself.

“Policy enforcement … access to a (set of) scopes” -- until this part Personal Information is used and there is no linkage to scope. We can help reader if we put ‘Personal Information (PI) resources that are referred to as scope’.

I don't quite understand your proposal here. The scope refers to resources (i.e. APIs/API operations in the case of the CAMARA use case) that may (or may not) provide access to personal information data. And if so, it is defined in the document as a PI scope that refers to a PI resource (i.e. API/API operation that provides access to personal information data).

In any case, the aim of this first PR is to create a first baseline document that will need to be edited and developed to document the final agreed solution.

[jpengar]

Fixed in #13 commit 4b76135
@gmuratk Please take a look.