Merge pull request #2 from irvinesunday/is/summaries

georgend · web-flow · commit 076c3e90051f · 2022-04-05T23:28:01.000+03:00
Update CRUD operations summaries and descriptions
diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyGetOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyGetOperationHandler.cs
@@ -45,8 +45,8 @@ protected override void SetBasicInfo(OpenApiOperation operation)
 
         // Summary and Description
         string placeHolder = $"Get {ComplexPropertySegment.Property.Name} property value";
-        operation.Summary = ReadRestrictions?.Description ?? Context.Model.GetDescriptionAnnotation(ComplexPropertySegment.Property) ?? placeHolder;
-        operation.Description = ReadRestrictions?.LongDescription ?? Context.Model.GetLongDescriptionAnnotation(ComplexPropertySegment.Property) ?? placeHolder;
+        operation.Summary = ReadRestrictions?.Description ?? placeHolder;
+        operation.Description = ReadRestrictions?.LongDescription ?? Context.Model.GetDescriptionAnnotation(ComplexPropertySegment.Property) ?? placeHolder;
 
         base.SetBasicInfo(operation);
     }
diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyPostOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyPostOperationHandler.cs
@@ -48,8 +48,8 @@ protected override void SetBasicInfo(OpenApiOperation operation)
 
         // Summary and Description
         string placeHolder = $"Sets a new value for the collection of {ComplexPropertySegment.ComplexType.Name}.";
-        operation.Summary = placeHolder;
-        operation.Description = InsertRestrictions?.Description ?? Context.Model.GetDescriptionAnnotation(ComplexPropertySegment.Property);
+        operation.Summary = InsertRestrictions?.Description ?? placeHolder;
+        operation.Description = InsertRestrictions?.LongDescription;
 
         base.SetBasicInfo(operation);
     }
diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyUpdateOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyUpdateOperationHandler.cs
@@ -33,8 +33,8 @@ protected override void SetBasicInfo(OpenApiOperation operation)
     {
         // Summary and Description
         string placeHolder = $"Update property {ComplexPropertySegment.Property.Name} value.";
-        operation.Summary = UpdateRestrictions?.Description ?? Context.Model.GetDescriptionAnnotation(ComplexPropertySegment.Property) ?? placeHolder;
-        operation.Description = UpdateRestrictions?.LongDescription ?? Context.Model.GetLongDescriptionAnnotation(ComplexPropertySegment.Property) ?? placeHolder;
+        operation.Summary = UpdateRestrictions?.Description ?? placeHolder;
+        operation.Description = UpdateRestrictions?.LongDescription ?? Context.Model.GetLongDescriptionAnnotation(ComplexPropertySegment.Property);
 
         // OperationId
         if (Context.Settings.EnableOperationId)
diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/EntityDeleteOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/EntityDeleteOperationHandler.cs
@@ -43,7 +43,7 @@ protected override void SetBasicInfo(OpenApiOperation operation)
             // Description
             string placeHolder = "Delete entity from " + EntitySet.Name;
             operation.Summary = DeleteRestrictions?.Description ?? placeHolder;
-            operation.Description = DeleteRestrictions?.LongDescription ?? placeHolder;
+            operation.Description = DeleteRestrictions?.LongDescription;
 
             // OperationId
             if (Context.Settings.EnableOperationId)
diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/EntityGetOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/EntityGetOperationHandler.cs
@@ -43,8 +43,8 @@ protected override void SetBasicInfo(OpenApiOperation operation)
 
             // Description
             string placeHolder = "Get entity from " + EntitySet.Name + " by key";
-            operation.Summary = ReadRestrictions?.ReadByKeyRestrictions?.Description ?? Context.Model.GetLongDescriptionAnnotation(entityType) ?? placeHolder;
-            operation.Description = ReadRestrictions?.ReadByKeyRestrictions?.LongDescription ?? Context.Model.GetLongDescriptionAnnotation(entityType) ?? placeHolder;
+            operation.Summary = ReadRestrictions?.ReadByKeyRestrictions?.Description ?? placeHolder;
+            operation.Description = ReadRestrictions?.ReadByKeyRestrictions?.LongDescription ?? Context.Model.GetDescriptionAnnotation(entityType) ?? placeHolder;
 
             // OperationId
             if (Context.Settings.EnableOperationId)
diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/EntitySetGetOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/EntitySetGetOperationHandler.cs
@@ -42,8 +42,8 @@ protected override void SetBasicInfo(OpenApiOperation operation)
         {
             // Summary and Descriptions
             string placeHolder = "Get entities from " + EntitySet.Name;
-            operation.Summary = ReadRestrictions?.Description ?? Context.Model.GetDescriptionAnnotation(EntitySet) ?? placeHolder;
-            operation.Description = ReadRestrictions?.LongDescription ?? Context.Model.GetLongDescriptionAnnotation(EntitySet) ?? placeHolder;
+            operation.Summary = ReadRestrictions?.Description ?? placeHolder;
+            operation.Description = ReadRestrictions?.LongDescription ?? Context.Model.GetDescriptionAnnotation(EntitySet);
 
             // OperationId
             if (Context.Settings.EnableOperationId)
diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/EntitySetPostOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/EntitySetPostOperationHandler.cs
@@ -42,7 +42,7 @@ protected override void SetBasicInfo(OpenApiOperation operation)
             // Summary and Description
             string placeHolder = "Add new entity to " + EntitySet.Name;
             operation.Summary = InsertRestrictions?.Description ?? placeHolder;
-            operation.Description = InsertRestrictions?.LongDescription ?? placeHolder;
+            operation.Description = InsertRestrictions?.LongDescription;
 
             // OperationId
             if (Context.Settings.EnableOperationId)
diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/EntityUpdateOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/EntityUpdateOperationHandler.cs
@@ -39,7 +39,7 @@ protected override void SetBasicInfo(OpenApiOperation operation)
             // Description
             string placeHolder = "Update entity in " + EntitySet.Name;
             operation.Summary = UpdateRestrictions?.Description ?? placeHolder;
-            operation.Description = UpdateRestrictions?.LongDescription ?? placeHolder;
+            operation.Description = UpdateRestrictions?.LongDescription;
 
             // OperationId
             if (Context.Settings.EnableOperationId)
diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/NavigationPropertyDeleteOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/NavigationPropertyDeleteOperationHandler.cs
@@ -24,18 +24,17 @@ internal class NavigationPropertyDeleteOperationHandler : NavigationPropertyOper
         /// <inheritdoc/>
         protected override void SetBasicInfo(OpenApiOperation operation)
         {
-            // Summary
-            operation.Summary = "Delete navigation property " + NavigationProperty.Name + " for " + NavigationSource.Name;
+            // Summary and Description
+            string placeHolder = "Delete navigation property " + NavigationProperty.Name + " for " + NavigationSource.Name;
+            operation.Summary = Restriction?.DeleteRestrictions?.Description ?? placeHolder;
+            operation.Description = Restriction?.DeleteRestrictions?.LongDescription;
 
             // OperationId
             if (Context.Settings.EnableOperationId)
             {
                 string prefix = "Delete";
                 operation.OperationId = GetOperationId(prefix);
-            }
-
-            // Description
-            operation.Description = Restriction?.DeleteRestrictions?.Description;
+            }            
 
             base.SetBasicInfo(operation);
         }
diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/NavigationPropertyGetOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/NavigationPropertyGetOperationHandler.cs
@@ -27,8 +27,12 @@ internal class NavigationPropertyGetOperationHandler : NavigationPropertyOperati
         /// <inheritdoc/>
         protected override void SetBasicInfo(OpenApiOperation operation)
         {
-            // Summary
-            operation.Summary = "Get " + NavigationProperty.Name + " from " + NavigationSource.Name;
+            // Summary and Description
+            ReadRestrictionsType readRestriction = Restriction?.ReadRestrictions;
+            string placeHolder = "Get " + NavigationProperty.Name + " from " + NavigationSource.Name;
+            operation.Summary = (LastSegmentIsKeySegment ? readRestriction?.ReadByKeyRestrictions?.Description : readRestriction?.Description) ?? placeHolder;    
+            operation.Description = (LastSegmentIsKeySegment ? readRestriction?.ReadByKeyRestrictions?.LongDescription : readRestriction?.LongDescription)
+                ?? Context.Model.GetDescriptionAnnotation(NavigationProperty);
 
             // OperationId
             if (Context.Settings.EnableOperationId)
@@ -41,12 +45,7 @@ protected override void SetBasicInfo(OpenApiOperation operation)
 
                 operation.OperationId = GetOperationId(prefix);
             }
-
-            // Description
-            ReadRestrictionsType readRestriction = Restriction?.ReadRestrictions;
-            operation.Description = (LastSegmentIsKeySegment ? readRestriction?.ReadByKeyRestrictions?.Description : readRestriction?.Description)
-                ?? Context.Model.GetDescriptionAnnotation(NavigationProperty);
-
+            
             base.SetBasicInfo(operation);
         }
 
diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/NavigationPropertyPostOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/NavigationPropertyPostOperationHandler.cs
@@ -25,8 +25,10 @@ internal class NavigationPropertyPostOperationHandler : NavigationPropertyOperat
         /// <inheritdoc/>
         protected override void SetBasicInfo(OpenApiOperation operation)
         {
-            // Summary
-            operation.Summary = "Create new navigation property to " + NavigationProperty.Name + " for " + NavigationSource.Name;
+            // Summary and Description
+            string placeHolder = "Create new navigation property to " + NavigationProperty.Name + " for " + NavigationSource.Name;
+            operation.Summary = Restriction?.InsertRestrictions?.Description ?? placeHolder;
+            operation.Description = Restriction?.InsertRestrictions?.LongDescription;
 
             // OperationId
             if (Context.Settings.EnableOperationId)
@@ -35,9 +37,6 @@ protected override void SetBasicInfo(OpenApiOperation operation)
                 operation.OperationId = GetOperationId(prefix);
             }
 
-            // Description
-            operation.Description = Restriction?.InsertRestrictions?.Description;
-
             base.SetBasicInfo(operation);
         }
 
diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/NavigationPropertyUpdateOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/NavigationPropertyUpdateOperationHandler.cs
@@ -22,8 +22,10 @@ internal abstract class NavigationPropertyUpdateOperationHandler : NavigationPro
         /// <inheritdoc/>
         protected override void SetBasicInfo(OpenApiOperation operation)
         {
-            // Summary
-            operation.Summary = "Update the navigation property " + NavigationProperty.Name + " in " + NavigationSource.Name;
+            // Summary and Description
+            string placeHolder = "Update the navigation property " + NavigationProperty.Name + " in " + NavigationSource.Name;
+            operation.Summary = Restriction?.UpdateRestrictions?.Description ?? placeHolder;
+            operation.Description = Restriction?.UpdateRestrictions?.LongDescription;
 
             // OperationId
             if (Context.Settings.EnableOperationId)
@@ -32,9 +34,6 @@ protected override void SetBasicInfo(OpenApiOperation operation)
                 operation.OperationId = GetOperationId(prefix);
             }
 
-            // Description
-            operation.Description = Restriction?.UpdateRestrictions?.Description;
-
             base.SetBasicInfo(operation);
         }
 
diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/RefDeleteOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/RefDeleteOperationHandler.cs
@@ -22,18 +22,17 @@ internal class RefDeleteOperationHandler : NavigationPropertyOperationHandler
         /// <inheritdoc/>
         protected override void SetBasicInfo(OpenApiOperation operation)
         {
-            // Summary
-            operation.Summary = "Delete ref of navigation property " + NavigationProperty.Name + " for " + NavigationSource.Name;
+            // Summary and Description
+            string placeHolder = "Delete ref of navigation property " + NavigationProperty.Name + " for " + NavigationSource.Name;
+            operation.Summary = Restriction?.DeleteRestrictions?.Description ?? placeHolder;
+            operation.Description = Restriction?.DeleteRestrictions?.LongDescription;
 
             // OperationId
             if (Context.Settings.EnableOperationId)
             {
                 string prefix = "DeleteRef";
                 operation.OperationId = GetOperationId(prefix);
-            }
-
-            // Description
-            operation.Description = Restriction?.DeleteRestrictions?.Description;
+            }            
         }
 
         /// <inheritdoc/>
diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/RefGetOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/RefGetOperationHandler.cs
@@ -25,8 +25,12 @@ internal class RefGetOperationHandler : NavigationPropertyOperationHandler
         /// <inheritdoc/>
         protected override void SetBasicInfo(OpenApiOperation operation)
         {
-            // Summary
-            operation.Summary = "Get ref of " + NavigationProperty.Name + " from " + NavigationSource.Name;
+            // Summary and Description
+            ReadRestrictionsType readRestriction = Restriction?.ReadRestrictions;
+            string placeHolder = "Get ref of " + NavigationProperty.Name + " from " + NavigationSource.Name;
+            operation.Summary = (LastSegmentIsKeySegment ? readRestriction?.ReadByKeyRestrictions?.Description : readRestriction?.Description) ?? placeHolder;
+            operation.Description = (LastSegmentIsKeySegment ? readRestriction?.ReadByKeyRestrictions?.LongDescription : readRestriction?.LongDescription)
+                ?? Context.Model.GetDescriptionAnnotation(NavigationProperty);
 
             // OperationId
             if (Context.Settings.EnableOperationId)
@@ -39,11 +43,6 @@ protected override void SetBasicInfo(OpenApiOperation operation)
 
                 operation.OperationId = GetOperationId(prefix);
             }
-
-            // Description
-            ReadRestrictionsType readRestriction = Restriction?.ReadRestrictions;
-            operation.Description = (LastSegmentIsKeySegment ? readRestriction?.ReadByKeyRestrictions?.Description : readRestriction?.Description)
-                ?? Context.Model.GetDescriptionAnnotation(NavigationProperty);
         }
 
         protected override void SetExtensions(OpenApiOperation operation)
diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/RefPostOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/RefPostOperationHandler.cs
@@ -22,8 +22,10 @@ internal class RefPostOperationHandler : NavigationPropertyOperationHandler
         /// <inheritdoc/>
         protected override void SetBasicInfo(OpenApiOperation operation)
         {
-            // Summary
-            operation.Summary = "Create new navigation property ref to " + NavigationProperty.Name + " for " + NavigationSource.Name;
+            // Summary and Description
+            string placeHolder = "Create new navigation property ref to " + NavigationProperty.Name + " for " + NavigationSource.Name;
+            operation.Summary = Restriction?.InsertRestrictions?.Description ?? placeHolder;
+            operation.Description = Restriction?.InsertRestrictions?.LongDescription;
 
             // OperationId
             if (Context.Settings.EnableOperationId)
@@ -32,8 +34,7 @@ protected override void SetBasicInfo(OpenApiOperation operation)
                 operation.OperationId = GetOperationId(prefix);
             }
 
-            // Description
-            operation.Description = Restriction?.InsertRestrictions?.Description;
+            
         }
 
         /// <inheritdoc/>
diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/RefPutOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/RefPutOperationHandler.cs
@@ -22,17 +22,17 @@ internal class RefPutOperationHandler : NavigationPropertyOperationHandler
         /// <inheritdoc/>
         protected override void SetBasicInfo(OpenApiOperation operation)
         {
-            // Summary
-            operation.Summary = "Update the ref of navigation property " + NavigationProperty.Name + " in " + NavigationSource.Name;
+            // Summary and Description
+            string placeHolder = "Update the ref of navigation property " + NavigationProperty.Name + " in " + NavigationSource.Name;
+            operation.Summary = Restriction?.UpdateRestrictions?.Description ?? placeHolder;
+            operation.Description = Restriction?.UpdateRestrictions?.LongDescription;
 
             // OperationId
             if (Context.Settings.EnableOperationId)
             {
                 string prefix = "UpdateRef";
                 operation.OperationId = GetOperationId(prefix);
             }
-
-            operation.Description = Restriction?.UpdateRestrictions?.Description;
         }
 
         /// <inheritdoc/>

Original file line number	Diff line number	Diff line change
`@@ -45,8 +45,8 @@ protected override void SetBasicInfo(OpenApiOperation operation)`
`45`	`45`
`46`	`46`	`// Summary and Description`
`47`	`47`	`string placeHolder = $"Get {ComplexPropertySegment.Property.Name} property value";`
`48`		`- operation.Summary = ReadRestrictions?.Description ?? Context.Model.GetDescriptionAnnotation(ComplexPropertySegment.Property) ?? placeHolder;`
`49`		`- operation.Description = ReadRestrictions?.LongDescription ?? Context.Model.GetLongDescriptionAnnotation(ComplexPropertySegment.Property) ?? placeHolder;`
	`48`	`+ operation.Summary = ReadRestrictions?.Description ?? placeHolder;`
	`49`	`+ operation.Description = ReadRestrictions?.LongDescription ?? Context.Model.GetDescriptionAnnotation(ComplexPropertySegment.Property) ?? placeHolder;`
`50`	`50`
`51`	`51`	`base.SetBasicInfo(operation);`
`52`	`52`	`}`
Original file line number	Diff line number	Diff line change
`@@ -48,8 +48,8 @@ protected override void SetBasicInfo(OpenApiOperation operation)`
`48`	`48`
`49`	`49`	`// Summary and Description`
`50`	`50`	`string placeHolder = $"Sets a new value for the collection of {ComplexPropertySegment.ComplexType.Name}.";`
`51`		`- operation.Summary = placeHolder;`
`52`		`- operation.Description = InsertRestrictions?.Description ?? Context.Model.GetDescriptionAnnotation(ComplexPropertySegment.Property);`
	`51`	`+ operation.Summary = InsertRestrictions?.Description ?? placeHolder;`
	`52`	`+ operation.Description = InsertRestrictions?.LongDescription;`
`53`	`53`
`54`	`54`	`base.SetBasicInfo(operation);`
`55`	`55`	`}`
Original file line number	Diff line number	Diff line change
`@@ -25,8 +25,10 @@ internal class NavigationPropertyPostOperationHandler : NavigationPropertyOperat`
`25`	`25`	`/// <inheritdoc/>`
`26`	`26`	`protected override void SetBasicInfo(OpenApiOperation operation)`
`27`	`27`	`{`
`28`		`- // Summary`
`29`		`- operation.Summary = "Create new navigation property to " + NavigationProperty.Name + " for " + NavigationSource.Name;`
	`28`	`+ // Summary and Description`
	`29`	`+ string placeHolder = "Create new navigation property to " + NavigationProperty.Name + " for " + NavigationSource.Name;`
	`30`	`+ operation.Summary = Restriction?.InsertRestrictions?.Description ?? placeHolder;`
	`31`	`+ operation.Description = Restriction?.InsertRestrictions?.LongDescription;`
`30`	`32`
`31`	`33`	`// OperationId`
`32`	`34`	`if (Context.Settings.EnableOperationId)`
`@@ -35,9 +37,6 @@ protected override void SetBasicInfo(OpenApiOperation operation)`
`35`	`37`	`operation.OperationId = GetOperationId(prefix);`
`36`	`38`	`}`
`37`	`39`
`38`		`- // Description`
`39`		`- operation.Description = Restriction?.InsertRestrictions?.Description;`
`40`		`-`
`41`	`40`	`base.SetBasicInfo(operation);`
`42`	`41`	`}`
`43`	`42`
Original file line number	Diff line number	Diff line change
`@@ -22,8 +22,10 @@ internal abstract class NavigationPropertyUpdateOperationHandler : NavigationPro`
`22`	`22`	`/// <inheritdoc/>`
`23`	`23`	`protected override void SetBasicInfo(OpenApiOperation operation)`
`24`	`24`	`{`
`25`		`- // Summary`
`26`		`- operation.Summary = "Update the navigation property " + NavigationProperty.Name + " in " + NavigationSource.Name;`
	`25`	`+ // Summary and Description`
	`26`	`+ string placeHolder = "Update the navigation property " + NavigationProperty.Name + " in " + NavigationSource.Name;`
	`27`	`+ operation.Summary = Restriction?.UpdateRestrictions?.Description ?? placeHolder;`
	`28`	`+ operation.Description = Restriction?.UpdateRestrictions?.LongDescription;`
`27`	`29`
`28`	`30`	`// OperationId`
`29`	`31`	`if (Context.Settings.EnableOperationId)`
`@@ -32,9 +34,6 @@ protected override void SetBasicInfo(OpenApiOperation operation)`
`32`	`34`	`operation.OperationId = GetOperationId(prefix);`
`33`	`35`	`}`
`34`	`36`
`35`		`- // Description`
`36`		`- operation.Description = Restriction?.UpdateRestrictions?.Description;`
`37`		`-`
`38`	`37`	`base.SetBasicInfo(operation);`
`39`	`38`	`}`
`40`	`39`
Original file line number	Diff line number	Diff line change
`@@ -22,8 +22,10 @@ internal class RefPostOperationHandler : NavigationPropertyOperationHandler`
`22`	`22`	`/// <inheritdoc/>`
`23`	`23`	`protected override void SetBasicInfo(OpenApiOperation operation)`
`24`	`24`	`{`
`25`		`- // Summary`
`26`		`- operation.Summary = "Create new navigation property ref to " + NavigationProperty.Name + " for " + NavigationSource.Name;`
	`25`	`+ // Summary and Description`
	`26`	`+ string placeHolder = "Create new navigation property ref to " + NavigationProperty.Name + " for " + NavigationSource.Name;`
	`27`	`+ operation.Summary = Restriction?.InsertRestrictions?.Description ?? placeHolder;`
	`28`	`+ operation.Description = Restriction?.InsertRestrictions?.LongDescription;`
`27`	`29`
`28`	`30`	`// OperationId`
`29`	`31`	`if (Context.Settings.EnableOperationId)`
`@@ -32,8 +34,7 @@ protected override void SetBasicInfo(OpenApiOperation operation)`
`32`	`34`	`operation.OperationId = GetOperationId(prefix);`
`33`	`35`	`}`
`34`	`36`
`35`		`- // Description`
`36`		`- operation.Description = Restriction?.InsertRestrictions?.Description;`
	`37`	`+`
`37`	`38`	`}`
`38`	`39`
`39`	`40`	`/// <inheritdoc/>`
Original file line number	Diff line number	Diff line change
`@@ -22,17 +22,17 @@ internal class RefPutOperationHandler : NavigationPropertyOperationHandler`
`22`	`22`	`/// <inheritdoc/>`
`23`	`23`	`protected override void SetBasicInfo(OpenApiOperation operation)`
`24`	`24`	`{`
`25`		`- // Summary`
`26`		`- operation.Summary = "Update the ref of navigation property " + NavigationProperty.Name + " in " + NavigationSource.Name;`
	`25`	`+ // Summary and Description`
	`26`	`+ string placeHolder = "Update the ref of navigation property " + NavigationProperty.Name + " in " + NavigationSource.Name;`
	`27`	`+ operation.Summary = Restriction?.UpdateRestrictions?.Description ?? placeHolder;`
	`28`	`+ operation.Description = Restriction?.UpdateRestrictions?.LongDescription;`
`27`	`29`
`28`	`30`	`// OperationId`
`29`	`31`	`if (Context.Settings.EnableOperationId)`
`30`	`32`	`{`
`31`	`33`	`string prefix = "UpdateRef";`
`32`	`34`	`operation.OperationId = GetOperationId(prefix);`
`33`	`35`	`}`
`34`		`-`
`35`		`- operation.Description = Restriction?.UpdateRestrictions?.Description;`
`36`	`36`	`}`
`37`	`37`
`38`	`38`	`/// <inheritdoc/>`