Skip to content

Commit 0f714c2

Browse files
authored
Removed partitioning
1 parent 8fc6ca4 commit 0f714c2

File tree

1 file changed

+6
-10
lines changed

1 file changed

+6
-10
lines changed

graph/patterns/namespace.md

Lines changed: 6 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,36 +2,32 @@
22

33
Microsoft Graph API Design Pattern
44

5-
### *The Namespace provides the ability to group resource definitions together into a logical set.*
5+
### *The Namespace provides the ability to organize resource definitions together into a logical set.*
66

77
## Problem
88

99
When building a complex offering API designers may need to model many different
1010
resources and their relationships. For better user experience and
11-
discoverability related API definitions need to be grouped together. Large API
12-
surface may need to be partitioned to generate light-weight client SDKs and
13-
libraries.
11+
discoverability related API elements need to be clustered together.
12+
1413

1514
## Solution
1615

1716
API designers can use the Namespace attribute of the CSDL schema to declare a
18-
namespace and logically bundle related API entities in the Graph metadata.
17+
namespace and logically organize related API entities in the Graph metadata.
1918

2019
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ XML
2120
<Schema Namespace="microsoft.graph.{namespace}">
2221
...
2322
</Schema>
2423
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2524

26-
All resources declared within the namespace will be grouped together in the
27-
public Graph metadata and may be used for partitioning.
28-
2925
A public namespace must have "microsoft.graph.” prefix and be presented in camel
3026
case, i.e microsoft.graph.myNamespace.
3127

32-
When type casting is required in the API query, request or response a fully
28+
When type casting is required in the API query, request or response, a fully
3329
qualified type name is represented as concatenation of a namespace and a type
34-
name. Consequently namespace should be aligned with API category path segment.
30+
name. Consequently namespaces should be aligned with API category path segment.
3531

3632
## When to Use this Pattern
3733

0 commit comments

Comments
 (0)