From 566bcae079ddc063747c0b0414787875ec22fc48 Mon Sep 17 00:00:00 2001
From: Fi Quick <47183728+fiquick@users.noreply.github.com>
Date: Fri, 4 Jul 2025 11:50:26 +0100
Subject: [PATCH 1/2] operators

---
 modules/ROOT/content-nav.adoc           |   1 +
 modules/ROOT/pages/query/operators.adoc | 123 ++++++++++++++++++++++++
 2 files changed, 124 insertions(+)
 create mode 100644 modules/ROOT/pages/query/operators.adoc

diff --git a/modules/ROOT/content-nav.adoc b/modules/ROOT/content-nav.adoc
index a85501ede..f222eeb65 100644
--- a/modules/ROOT/content-nav.adoc
+++ b/modules/ROOT/content-nav.adoc
@@ -76,6 +76,7 @@ Generic Start
 ** xref:query/introduction.adoc[What is Query?]
 ** xref:query/visual-tour.adoc[Visual tour]
 ** xref:query/operations.adoc[Query operations]
+** xref:query/operators.adoc[Operators]
 
 * xref:apoc.adoc[APOC support]
 
diff --git a/modules/ROOT/pages/query/operators.adoc b/modules/ROOT/pages/query/operators.adoc
new file mode 100644
index 000000000..2acaffed2
--- /dev/null
+++ b/modules/ROOT/pages/query/operators.adoc
@@ -0,0 +1,123 @@
+= Operators
+
+Operator commands are part of a shell-like interface within the Aura console and act as a built-in system tool.
+
+The following commands are accessed by typing `:` in the Neo4j Aura console:
+
+[source,cypher]
+----
+:access-mode
+:clear
+:connect
+:disconnect
+:history
+:param
+:play
+:server
+:style
+:style reset
+:sysinfo
+:use
+:welcome
+----
+
+== Command descriptions
+
+=== `:access-mode`
+
+Controls whether queries are sent in read or write mode.
+
+- Useful for load balancing or enforcing read-only sessions.
+- Current mode: `WRITE` (if shown in UI)
+
+=== `:connect` / `:disconnect`
+
+Establishes or terminates the connection to a database instance.
+
+=== `:param`
+
+Used to create or view Cypher parameters.
+
+- Parameters can be created either via the parameters sidebar (`{}`) or by invoking this command in the query editor.
+- See the official syntax guide at https://neo4j.com/docs/cypher-manual/current/syntax/parameters/
+
+.Example
+[source,cypher]
+----
+:param {
+  name: "Beatriz",
+  date: date("2025-07-03")
+}
+----
+
+=== `:clear`
+
+Clears the current output or query history in the UI.
+
+=== `:history`
+
+Brings up the list of previously executed queries and commands.
+
+=== `:play` 
+
+Launches built-in tutorials, interactive guides, or datasets.
+
+.Example
+[source,cypher]
+----
+:play movies
+----
+
+=== `:server`
+
+Displays server connection details or instance metadata.
+
+=== `:style` / `:style reset`
+
+- `:style` applies styling presets to the graph visualization.
+- `:style reset` reverts those styles to default.
+
+=== `:sysinfo`
+
+[TIP]
+====
+Use `:sysinfo` to investigate slow queries, memory pressure, or diagnose unexpected behavior in Aura instances.
+====
+
+Provides valuable diagnostic insights, especially for users working in Aura where file system access is not available.
+It provides the following info in the UI:
+
+[cols="1,3"]
+|===
+| *Section* | *Description*
+
+| ID Allocation
+| Tracks ID space usage for nodes, relationships, and relationship types.
+
+| Store Size
+| Shows total and per-database disk usage.
+
+| Page Cache
+| Displays hit ratio, memory usage, and page fault stats.
+
+| Transactions
+| Indicates current, peak, and committed transaction counts.
+
+| Databases
+| Lists online databases, default/home status, and roles.
+|===
+
+=== `:use`
+
+Switches between databases.
+
+.Example
+[source,cypher]
+----
+:use neo4j
+----
+
+=== `:welcome`
+
+Loads the welcome panel or quickstart UI in the query view.
+

From ba937e653e0e69778a3c0f6411d370dc09a29e2f Mon Sep 17 00:00:00 2001
From: Fi Quick <47183728+fiquick@users.noreply.github.com>
Date: Fri, 4 Jul 2025 11:51:33 +0100
Subject: [PATCH 2/2] update

---
 modules/ROOT/pages/query/operators.adoc | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/modules/ROOT/pages/query/operators.adoc b/modules/ROOT/pages/query/operators.adoc
index 2acaffed2..b88e96ef2 100644
--- a/modules/ROOT/pages/query/operators.adoc
+++ b/modules/ROOT/pages/query/operators.adoc
@@ -79,13 +79,9 @@ Displays server connection details or instance metadata.
 
 === `:sysinfo`
 
-[TIP]
-====
 Use `:sysinfo` to investigate slow queries, memory pressure, or diagnose unexpected behavior in Aura instances.
-====
-
-Provides valuable diagnostic insights, especially for users working in Aura where file system access is not available.
-It provides the following info in the UI:
+It provides valuable diagnostic insights, especially for users working in Aura where file system access is not available.
+The following info is displayed in the Aura console:
 
 [cols="1,3"]
 |===