fix examples and polish

Author: stefano-ottolenghi

modules/ROOT/pages/expressions/predicates/type-predicate-expressions.adoc

@@ -305,7 +305,16 @@ Cypher will therefore regard any exact numerical parameter as an `INTEGER` regar
 For example, an `INT16` or an `INT32` passed through from a link:https://neo4j.com/docs/create-applications/[language library] will both be treated by Cypher as an `INTEGER`.
 Note that any exact numerical parameter used must fit within the range of an `INT64`.
 
-[source, cypher, role=test-skip]
+////
+[source, parameters]
+----
+{
+  "int16param": 65537
+}
+----
+////
+
+[source, cypher]
 ----
 RETURN $int16param IS :: INTEGER AS isInteger
 ----

modules/ROOT/pages/functions/vector.adoc

@@ -39,8 +39,7 @@ This includes the potential of lossy conversion in cases where a larger type, e.
 .Query
 [source, cypher]
 ----
-WITH vector([1, 2, 3], 3, INTEGER) AS vector
-RETURN vector
+RETURN vector([1, 2, 3], 3, INTEGER) AS vector
 ----
 
 .Result
@@ -61,8 +60,7 @@ RETURN vector
 .Query
 [source, cypher]
 ----
-WITH vector("[1.05000e+00, 0.123, 5]", 3, FLOAT32) as vector
-RETURN vector
+RETURN vector("[1.05000e+00, 0.123, 5]", 3, FLOAT32) AS vector
 ----
 
 .Result
@@ -183,6 +181,16 @@ CREATE
 Given a parameter `query` (here set to `[4.0, 5.0, 6.0]`), you can query for the two nearest neighbors by Euclidean distance.
 This is achieved by matching on all candidate vectors and ordering by the similarity score:
 
+////
+.Parameters
+[source, parameters]
+----
+{
+  "query": [4.0, 5.0, 6.0]
+}
+----
+////
+
 [source, cypher]
 ----
 MATCH (node:Node)
@@ -200,10 +208,10 @@ This returns the two nearest neighbors.
 | node
 | score
 
-| (:Node {vector: [2.0, 8.0, 3.0], id: 3})
+| (:Node {vector: vector([2.0, 8.0, 3.0], 3, FLOAT32 NOT NULL), id: 3})
 | 0.043478261679410934
 
-| (:Node {vector: [1.0, 4.0, 2.0], id: 1})
+| (:Node {vector: vector([1.0, 4.0, 2.0], 3, FLOAT32 NOT NULL), id: 1})
 | 0.03703703731298447
 
 2+d|Rows: 2

modules/ROOT/pages/values-and-types/vector.adoc

@@ -1,10 +1,11 @@
 = Vectors
-:description: Information about Cypher's `VECTOR` type.
+:description: Create and store vectors (embeddings) as properties on nodes and relationships, and use them for efficient semantic retrieval with vector indexes and the GenAI plugin.
 :page-role: new-neo4j-2025.10
 
 `VECTOR` values can be created and stored as xref:indexes/semantic-indexes/vector-indexes.adoc#embeddings[embedding] properties on nodes and relationships, and used for efficient semantic retrieval using xref:indexes/semantic-indexes/vector-indexes.adoc[vector indexes] and the xref:genai-integrations.adoc[GenAI plugin].
 `VECTOR` values can also be measured and compared (in terms of similarity, distance, and norm) using xref:functions/vector.adoc[vector functions].
 
+
 [[vector-type]]
 == The vector type
 
@@ -57,8 +58,7 @@ To construct a `VECTOR` value, use the xref:functions/vector.adoc#functions-vect
 .Query
 [source, cypher]
 ----
-WITH vector([1, 2, 3], 3, INTEGER) AS vector
-RETURN vector
+RETURN vector([1, 2, 3], 3, INTEGER) AS vector
 ----
 
 .Result
@@ -87,8 +87,7 @@ RETURN vector
 .Query
 [source, cypher]
 ----
-WITH vector($integerList, 5, INTEGER8) as vector
-RETURN vector
+RETURN vector($integerList, 5, INTEGER8) AS vector
 ----
 
 .Result