Review of the Cypher intro tutorial #504

lidiazuin · 2025-11-06T12:04:07Z

No description provided.

AlexicaWright

Whew..loads of comments! Useful content! Thank you @lidiazuin !

modules/ROOT/pages/cypher/index.adoc

AlexicaWright · 2025-11-06T13:07:57Z

modules/ROOT/pages/cypher/index.adoc

+Neo4j's graph model is composed of <<nodes>> and <<relationships>>, which may also have assigned <<properties>>.
+With nodes and relationships, you can build powerful patterns that can express simple or complex patterns.
+
+Pattern recognition is a key fundamental cognitive process, making Cypher, which utilizes pattern matching, intuitive and easy to learn.


Is it really easy to learn? Maybe it's better to just say that it's intuitive?

AlexicaWright · 2025-11-06T16:32:04Z

modules/ROOT/pages/cypher/intro-tutorial.adoc

+
+image::kevinthreehopsrel.svg[Three hops from Kevin Bacon and other actors and movies, now connected through acted in, directed and produced relationships, link="{imagesdir}/kevinthreehopsrel.svg",role="popup-link"]
+
+=== The Bacon Path to Meg Ryan


Suggested change

=== The Bacon Path to Meg Ryan

=== Use the `ShortestPath` algorithm

This doesn't solve the Six degrees of Kevin Bacon though, you would have to manually update the query for every actor and count the steps to see if it's six or less.

AlexicaWright · 2025-11-06T16:35:10Z

modules/ROOT/pages/cypher/intro-tutorial.adoc

+When you're done experimenting, you can remove the movie data set and clean up your Aura instance.
+However, for this to work, you need to delete all relationships, since nodes can't be removed if relationships to them still exist.


Suggested change

When you're done experimenting, you can remove the movie data set and clean up your Aura instance.

However, for this to work, you need to delete all relationships, since nodes can't be removed if relationships to them still exist.

When you're done experimenting, you can remove all the nodes and relationships in the movie data set.

AlexicaWright · 2025-11-06T16:35:45Z

modules/ROOT/pages/cypher/intro-tutorial.adoc

+When you're done experimenting, you can remove the movie data set and clean up your Aura instance.
+However, for this to work, you need to delete all relationships, since nodes can't be removed if relationships to them still exist.
+
+You can delete both relationships and nodes in one single query:


Suggested change

You can delete both relationships and nodes in one single query:

You can delete everything with one single query:

Originally there was a mention that this doesn't delete the properties, so I thought this should be specified?

I think we need to get to the bottom of this. Maybe someone from the Cypher team can help?

AlexicaWright · 2025-11-06T16:39:47Z

modules/ROOT/pages/cypher/intro-tutorial.adoc

+The result is the following message: "Deleted 171 nodes, deleted 253 relationships".
+
+Note that, although the database information in the left-hand panel shows no nodes or relationships in the graph, the property key names remain.
+This means that the previous query delete only nodes and relationships, but not properties.


I'm not sure this is accurate. The property keys remain, but aren't their values stored on the nodes? And if you remove the nodes, where are the values?
How can you REMOVE a property from a node that has been deleted?

modules/ROOT/pages/cypher/intro-tutorial.adoc

AlexicaWright

Whew..loads of comments! Useful content! Thank you @lidiazuin !

Co-authored-by: Jessica Wright <[email protected]>

AlexicaWright

Amazing work! Some more comments for clarification and readability.

modules/ROOT/pages/cypher/index.adoc

AlexicaWright · 2025-11-20T12:54:01Z

modules/ROOT/pages/cypher/index.adoc

+Neo4j's graph model is composed of <<nodes>> and <<relationships>>, which may also have assigned <<properties>>.
+With nodes and relationships, you can build a graph that can express both simple and complex patterns.
+
+Pattern recognition is a key fundamental cognitive process, making Cypher, which utilizes pattern matching, more intuitive to learn.


It's kind of awkward to say that Cypher utilizes pattern matching, it's more the other way around, that you can use Cypher for pattern matching.

AlexicaWright · 2025-11-20T12:58:53Z

modules/ROOT/pages/cypher/index.adoc

+endif::[]
+
+Cypher's constructs are based on English prose and iconography.
+It allows the user to get a natural language understanding while programming.


Cypher is not a programming language, it's a query language. Maybe we could say something like that it's close to natural language and the syntax is designed to visually look like a graph?

modules/ROOT/pages/cypher/index.adoc

AlexicaWright · 2025-11-20T13:54:54Z

modules/ROOT/pages/cypher/index.adoc

+==== Pattern variables
+
+In the same way as nodes and relationships, you can also use variables for patterns.
+Considering the previous example, you can turn contain the whole pattern (`(Sally)-[:LIKES]->(Technology)`) inside a pattern by creating a variable (`p`) for it all:


Suggested change

Considering the previous example, you can turn contain the whole pattern (`(Sally)-[:LIKES]->(Technology)`) inside a pattern by creating a variable (`p`) for it all:

Consider the previous example, you can turn the whole pattern (`(Sally)-[:LIKES]->(Technology)`) into a variable (`p`):

Co-authored-by: Jessica Wright <[email protected]>

AlexicaWright

Looks great @lidiazuin ! I found just one missing space, otherwise I say it's ago! 👍

modules/ROOT/pages/cypher/index.adoc

Co-authored-by: Jessica Wright <[email protected]>

neo4j-docops-agent · 2025-11-24T09:26:54Z

Thanks for the documentation updates.

The preview documentation has now been torn down - reopening this PR will republish it.

* Review of the Cypher intro tutorial * Apply suggestions from code review Co-authored-by: Jessica Wright <[email protected]> * Apply suggestions from code review Co-authored-by: Jessica Wright <[email protected]> * update after review * last updates after review * Apply suggestions from code review Co-authored-by: Jessica Wright <[email protected]> * updates after review * Update modules/ROOT/pages/cypher/index.adoc Co-authored-by: Jessica Wright <[email protected]> --------- Co-authored-by: Jessica Wright <[email protected]>

* Review of the Cypher intro tutorial (#504) * Review of the Cypher intro tutorial * Apply suggestions from code review Co-authored-by: Jessica Wright <[email protected]> * Apply suggestions from code review Co-authored-by: Jessica Wright <[email protected]> * update after review * last updates after review * Apply suggestions from code review Co-authored-by: Jessica Wright <[email protected]> * updates after review * Update modules/ROOT/pages/cypher/index.adoc Co-authored-by: Jessica Wright <[email protected]> --------- Co-authored-by: Jessica Wright <[email protected]> * fixing issues --------- Co-authored-by: Jessica Wright <[email protected]>

Review of the Cypher intro tutorial

5ec028b

lidiazuin added the cherry-pick-this-to-main label Nov 6, 2025

AlexicaWright reviewed Nov 6, 2025

View reviewed changes

lidiazuin and others added 4 commits November 7, 2025 10:44

Apply suggestions from code review

da46552

Co-authored-by: Jessica Wright <[email protected]>

Apply suggestions from code review

1cdb638

Co-authored-by: Jessica Wright <[email protected]>

update after review

6b81125

last updates after review

2ac9ec5

lidiazuin requested a review from AlexicaWright November 18, 2025 13:13

AlexicaWright reviewed Nov 20, 2025

View reviewed changes

lidiazuin and others added 2 commits November 20, 2025 15:30

Apply suggestions from code review

3c849f9

Co-authored-by: Jessica Wright <[email protected]>

updates after review

bb9df0e

AlexicaWright reviewed Nov 24, 2025

View reviewed changes

modules/ROOT/pages/cypher/index.adoc Outdated Show resolved Hide resolved

Update modules/ROOT/pages/cypher/index.adoc

0fc4a81

Co-authored-by: Jessica Wright <[email protected]>

lidiazuin merged commit 014c584 into neo4j:dev Nov 24, 2025
5 checks passed

lidiazuin deleted the cypherintro branch November 24, 2025 09:37

lidiazuin mentioned this pull request Nov 24, 2025

Review of the Cypher intro tutorial #504 #505

Merged


		image::kevinthreehopsrel.svg[Three hops from Kevin Bacon and other actors and movies, now connected through acted in, directed and produced relationships, link="{imagesdir}/kevinthreehopsrel.svg",role="popup-link"]

		=== The Bacon Path to Meg Ryan

	=== The Bacon Path to Meg Ryan
	=== Use the `ShortestPath` algorithm

		When you're done experimenting, you can remove the movie data set and clean up your Aura instance.
		However, for this to work, you need to delete all relationships, since nodes can't be removed if relationships to them still exist.

	You can delete both relationships and nodes in one single query:
	You can delete everything with one single query:

	Considering the previous example, you can turn contain the whole pattern (`(Sally)-[:LIKES]->(Technology)`) inside a pattern by creating a variable (`p`) for it all:
	Consider the previous example, you can turn the whole pattern (`(Sally)-[:LIKES]->(Technology)`) into a variable (`p`):

Review of the Cypher intro tutorial #504

Review of the Cypher intro tutorial #504

Uh oh!

Conversation

lidiazuin commented Nov 6, 2025

Uh oh!

AlexicaWright left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

AlexicaWright left a comment

Choose a reason for hiding this comment

Uh oh!

AlexicaWright left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

AlexicaWright left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

neo4j-docops-agent commented Nov 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

neo4j-docops-agent commented Nov 24, 2025 •

edited

Loading