This is an automated email from the ASF dual-hosted git repository.

dehowef pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/age-website.git


The following commit(s) were added to refs/heads/master by this push:
     new 22b169c9 Update delete.md to be more clear (#165)
22b169c9 is described below

commit 22b169c917cd98085de744818c1d9c9655dae099
Author: Matheus Farias de Oliveira Matsumoto 
<[email protected]>
AuthorDate: Mon Sep 25 21:21:22 2023 -0300

    Update delete.md to be more clear (#165)
    
    The DELETE clause section is written in a not-so-clear way regarding 
deleting a "single vertex". Some might understand that a single vertex is only 
one vertex, when actually it means isolated vertices (vertices with no edges 
associated with them).
    
    Also, the first sentence on "Delete all vertices and edges" states that 
"Running a Match clause will collect all nodes". The "Delete single vertex" 
section doesn't start with that, but it does use the MATCH clause for finding 
all the nodes as well.
    
    There is a discussion about this on issue #387 on the Apache AGE 
repository: https://github.com/apache/age/issues/387
---
 docs/clauses/delete.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/clauses/delete.md b/docs/clauses/delete.md
index bc3efac5..507be497 100644
--- a/docs/clauses/delete.md
+++ b/docs/clauses/delete.md
@@ -14,9 +14,9 @@ For removing properties, see REMOVE.
 You cannot delete a node without also deleting edges that start or end on said 
vertex. Either explicitly delete the vertices,or use DETACH DELETE.
 
 
-## Delete single vertex
+## Delete isolated vertices
 
-To delete a vertex, use the DELETE clause.
+To delete vertices with no edges associated with them, use the DELETE clause 
only.
 
 Query
 
@@ -30,7 +30,7 @@ $$) as (v agtype);
 ```
 
 
-Nothing is returned from this query.
+This will delete the vertices (with label Useless) that have no edges. Nothing 
is returned from this query.
 
 
 <table>
@@ -44,9 +44,9 @@ Nothing is returned from this query.
   </tr>
 </table>
 
-## Delete all vertices and edges
+## Delete all vertices and edges associated with them
 
-Running a Match clause will collect all nodes, use the DETACH option to first 
delete a vertice's edges then delete the vertex itself.
+To delete all vertices (with label Useless) and the edges associated with 
them, use the DETACH option to first delete the vertice's edges then delete the 
vertex itself.
 
 Query
 

Reply via email to