DOC-746 | Removing vertices with Gharial deletes its edges (#690)

* Removing vertices with Gharial deletes its edges

And removing edges may remove other edges if the former are used as vertices

* Only incoming and outgoing edges are removed when deleting a vertex or edge (non-recursive)

The internal query is simply:
FOR e IN @@collection
  FILTER e._from == @toDeleteId OR e._to == @toDeleteId
  REMOVE e IN @@collection

Author: Simran-B

site/content/3.11/develop/http-api/graphs/named-graphs.md

@@ -5218,7 +5218,8 @@ paths:
     delete:
       operationId: deleteVertex
       description: |
-        Removes a vertex from the collection.
+        Removes a vertex from a collection of the named graph. Additionally removes all
+        incoming and outgoing edges of the vertex.
       parameters:
         - name: database-name
           in: path
@@ -7302,7 +7303,8 @@ paths:
     delete:
       operationId: deleteEdge
       description: |
-        Removes an edge from the collection.
+        Removes an edge from an edge collection of the named graph. Any other edges
+        that directly reference this edge like a vertex are removed, too.
       parameters:
         - name: database-name
           in: path

site/content/3.11/graphs/general-graphs/management.md

@@ -670,7 +670,8 @@ graph.female.update("female/linda", {name: "Linda", _key: "linda"}, { returnOld:
 
 ### Remove a Vertex
 
-Removes a vertex in collection `vertexCollectionName`.
+Removes a vertex from a collection of the named graph. Additionally removes all
+incoming and outgoing edges of the vertex.
 
 `graph.vertexCollectionName.remove(vertexId, options)`
 
@@ -679,9 +680,6 @@ Removes a vertex in collection `vertexCollectionName`.
 - `options` (object, _optional_):
   See the [_collection_ object](../../develop/javascript-api/@arangodb/collection-object.md#collectionremoveobject)
 
-Additionally removes all ingoing and outgoing edges of the vertex recursively
-(see [edge remove](#remove-an-edge)).
-
 **Examples**
 
 ```js
@@ -808,7 +806,8 @@ graph.relation.update("relation/aliceAndDiana",
 
 ### Remove an Edge
 
-Removes an edge in collection `edgeCollectionName`.
+Removes an edge from an edge collection of the named graph. Any other edges
+that directly reference this edge like a vertex are removed, too.
 
 `graph.edgeCollectionName.remove(edgeId, options)`
 
@@ -817,9 +816,6 @@ Removes an edge in collection `edgeCollectionName`.
 - `options` (object, _optional_):
   See the [_collection_ object](../../develop/javascript-api/@arangodb/collection-object.md#collectionremoveobject)
 
-If this edge is used as a vertex by another edge, the other edge is removed
-(recursively).
-
 **Examples**
 
 ```js

site/content/3.12/develop/http-api/graphs/named-graphs.md

@@ -5218,7 +5218,8 @@ paths:
     delete:
       operationId: deleteVertex
       description: |
-        Removes a vertex from the collection.
+        Removes a vertex from a collection of the named graph. Additionally removes all
+        incoming and outgoing edges of the vertex.
       parameters:
         - name: database-name
           in: path
@@ -7302,7 +7303,8 @@ paths:
     delete:
       operationId: deleteEdge
       description: |
-        Removes an edge from the collection.
+        Removes an edge from an edge collection of the named graph. Any other edges
+        that directly reference this edge like a vertex are removed, too.
       parameters:
         - name: database-name
           in: path

site/content/3.12/graphs/general-graphs/management.md

@@ -670,7 +670,8 @@ graph.female.update("female/linda", {name: "Linda", _key: "linda"}, { returnOld:
 
 ### Remove a Vertex
 
-Removes a vertex in collection `vertexCollectionName`.
+Removes a vertex from a collection of the named graph. Additionally removes all
+incoming and outgoing edges of the vertex.
 
 `graph.vertexCollectionName.remove(vertexId, options)`
 
@@ -679,9 +680,6 @@ Removes a vertex in collection `vertexCollectionName`.
 - `options` (object, _optional_):
   See the [_collection_ object](../../develop/javascript-api/@arangodb/collection-object.md#collectionremoveobject)
 
-Additionally removes all ingoing and outgoing edges of the vertex recursively
-(see [edge remove](#remove-an-edge)).
-
 **Examples**
 
 ```js
@@ -808,7 +806,8 @@ graph.relation.update("relation/aliceAndDiana",
 
 ### Remove an Edge
 
-Removes an edge in collection `edgeCollectionName`.
+Removes an edge from an edge collection of the named graph. Any other edges
+that directly reference this edge like a vertex are removed, too.
 
 `graph.edgeCollectionName.remove(edgeId, options)`
 
@@ -817,9 +816,6 @@ Removes an edge in collection `edgeCollectionName`.
 - `options` (object, _optional_):
   See the [_collection_ object](../../develop/javascript-api/@arangodb/collection-object.md#collectionremoveobject)
 
-If this edge is used as a vertex by another edge, the other edge is removed
-(recursively).
-
 **Examples**
 
 ```js

site/content/3.13/develop/http-api/graphs/named-graphs.md

@@ -5218,7 +5218,8 @@ paths:
     delete:
       operationId: deleteVertex
       description: |
-        Removes a vertex from the collection.
+        Removes a vertex from a collection of the named graph. Additionally removes all
+        incoming and outgoing edges of the vertex.
       parameters:
         - name: database-name
           in: path
@@ -7302,7 +7303,8 @@ paths:
     delete:
       operationId: deleteEdge
       description: |
-        Removes an edge from the collection.
+        Removes an edge from an edge collection of the named graph. Any other edges
+        that directly reference this edge like a vertex are removed, too.
       parameters:
         - name: database-name
           in: path

site/content/3.13/graphs/general-graphs/management.md

@@ -670,7 +670,8 @@ graph.female.update("female/linda", {name: "Linda", _key: "linda"}, { returnOld:
 
 ### Remove a Vertex
 
-Removes a vertex in collection `vertexCollectionName`.
+Removes a vertex from a collection of the named graph. Additionally removes all
+incoming and outgoing edges of the vertex.
 
 `graph.vertexCollectionName.remove(vertexId, options)`
 
@@ -679,9 +680,6 @@ Removes a vertex in collection `vertexCollectionName`.
 - `options` (object, _optional_):
   See the [_collection_ object](../../develop/javascript-api/@arangodb/collection-object.md#collectionremoveobject)
 
-Additionally removes all ingoing and outgoing edges of the vertex recursively
-(see [edge remove](#remove-an-edge)).
-
 **Examples**
 
 ```js
@@ -808,7 +806,8 @@ graph.relation.update("relation/aliceAndDiana",
 
 ### Remove an Edge
 
-Removes an edge in collection `edgeCollectionName`.
+Removes an edge from an edge collection of the named graph. Any other edges
+that directly reference this edge like a vertex are removed, too.
 
 `graph.edgeCollectionName.remove(edgeId, options)`
 
@@ -817,9 +816,6 @@ Removes an edge in collection `edgeCollectionName`.
 - `options` (object, _optional_):
   See the [_collection_ object](../../develop/javascript-api/@arangodb/collection-object.md#collectionremoveobject)
 
-If this edge is used as a vertex by another edge, the other edge is removed
-(recursively).
-
 **Examples**
 
 ```js