Revert "DOC-12533: Feedback on Language Constructs (#297)"

This reverts commit 60bc781.

Author: simon-dew

modules/eventing/pages/eventing-language-constructs.adoc

@@ -15,10 +15,10 @@ Certain capabilities have been removed and are not supported in order to handle
 
 Eventing Functions support the following features:
 
-* <<basic_bucket_accessors>>
-* <<advanced_bucket_accessors>>
-* <<logging>>
-* <<n1ql_statements>>
+* <<basic_bucket_accessors,Basic Keyspace Accessors>>
+* <<advanced_bucket_accessors,Advanced Keyspace Accessors>>
+* <<logging,Logging>>
+* <<n1ql_statements,{sqlpp} Statements>>
 
 [#basic_bucket_accessors]
 === Basic Keyspace Accessors
@@ -77,7 +77,7 @@ function OnUpdate(doc, meta) {
 Advanced Keyspace Accessors expose a larger set of options and operators than <<basic_bucket_accessors,Basic Keyspace Accessors>>.
 They have non-trivial argument sets and return values.
 
-See xref:eventing-advanced-keyspace-accessors.adoc[] for more details.
+See xref:eventing-advanced-keyspace-accessors.adoc[Advanced Keyspace Accessors] for more details.
 
 [#logging]
 === Logging
@@ -198,10 +198,10 @@ To include comments in multiline statements, use `/* this format */` instead.
 
 The following features are not supported by Eventing Functions:
 
-* <<global-state>>
-* <<asynchrony>>
-* <<browser_extensions>>
-* <<library_imports>>
+* <<global-state,Global State>>
+* <<asynchrony,Asynchrony>>
+* <<browser_extensions,Browser and Other Extensions>>
+* <<library_imports,Library Imports>>
 
 [#global-state]
 === Global State
@@ -266,13 +266,13 @@ The Eventing Service does not support importing libraries into Eventing Function
 
 Eventing Functions support the following built-in functions:
 
-* <<n1ql_call>>
-* <<analytics_call>>
-* <<crc64_call>>
-* <<crc_64_go_iso_call>>
-* <<base64_call>>
-* <<timers_general>>
-* <<curl_call>>
+* <<n1ql_call,`N1QL()`>>
+* <<analytics_call,`ANALYTICS()`>>
+* <<crc64_call,`crc64()`>>
+* <<crc_64_go_iso_call, `crc_64_go_iso()`>>
+* <<base64_call,`base64()`>>
+* <<timers_general,`createTimer()` and `cancelTimer()`>>
+* <<curl_call,`curl()`>>
 
 [#n1ql_call]
 === `N1QL()`
@@ -378,42 +378,53 @@ The `close()` method on the iterable handle can throw an exception if the underl
 |===
 
 [#analytics_call]
-=== `couchbase.{zwsp}analyticsQuery({wj})`
+=== `ANALYTICS()`
 
 ifeval::['{page-component-version}' == '7.6'] 
+
 [.status]#Introduced in Couchbase Server 7.6#
 endif::[]
 
-The `couchbase.analyticsQuery()` function provides integration with {sqlpp} Analytics directly from the Eventing Service.
+The `ANALYTICS()` function provides integration with {sqlpp} Analytics directly from the Eventing Service.
 
 Integrating Eventing with Analytics:
 
 * Allows Eventing to benefit from the high availability and load balancing of Analytics, where requests can take turns being submitted across nodes
 * Simplifies Eventing code logic and improves code readability
 * Eliminates security and network latency issues with the `curl()` function
 
-The following example assumes that the Analytics collection (dataset) called `default` already exists.
-
 [source,javascript]
 ----
 function OnUpdate(doc, meta) {
-    var count = 0;
-    const limit = 4;
-
-    let query = couchbase.analyticsQuery('SELECT * FROM default LIMIT $limit;', {
-        "limit": limit
-    });
-    for (let row of query) {
-        ++count;
-    }
+    // Ignore information we don't care about
+    if (doc.type !== 'airline') return;
+
+    // Get the total routes per IATA
+    var route_cnt = 0;     
+    // Uses a true variable as a SQL++ parameter  
+    var airline = doc.iata;  
+
+    var results = ANALYTICS(
+        "SELECT COUNT(*) AS cnt
+        FROM `travel-sample`.`inventory`.`route`
+        WHERE type = \"route\" 
+		AND airline = $1", [doc.iata]
+    );
 
-    if (count === limit) {
-        dst_bucket[meta.id] = 'yes';
+    // Stream results using the 'for' iterator
+    for (var item of results) {   
+        route_cnt = item.cnt;
     }
+
+    // End the query and free the resources held
+    results.close();    
+
+    // Log the KEY, AIRLINE and ROUTE_CNT
+    log("key: " + meta.id + ", airline: " + doc.iata + ", route_cnt: " + route_cnt);
 }
 ----
 
-For more information about {sqlpp} Analytics, see xref:server:analytics:1_intro.adoc[].
+For more information about {sqlpp} Analytics, see xref:server:analytics:1_intro.adoc[What’s SQL++ for Analytics?].
 
 [#crc64_call]
 === `crc64()`
@@ -547,24 +558,24 @@ To cancel a Timer, you can do one of the following:
 * Call the `createTimer()` function again using a reference from the existing Timer you want to cancel.
 * Call the `cancelTimer()` function using `cancelTimer(callback, reference)`.
 
-For more information about Timers, see xref:eventing-timers.adoc[].
+For more information about Timers, see xref:eventing-timers.adoc[Timers].
 
 [#curl_call]
 === `curl()`
 
 The `curl()` function lets you interact with external entities through a REST endpoint from Eventing Functions, using either HTTP or HTTPS.
 
-For more information about the `curl()` function, see xref:eventing-curl-spec.adoc[].
+For more information about the `curl()` function, see xref:eventing-curl-spec.adoc[cURL].
 
 
 [#handler-signatures]
 == Handler Signatures
 
 The Eventing Service calls the following JavaScript functions on events like mutations and fired Timers:
 
-* <<onupdate_handler>>
-* <<ondelete_handler>>
-* <<timer_callback_handler>>
+* <<onupdate_handler,OnUpdate Handler>>
+* <<ondelete_handler,OnDelete Handler>>
+* <<timer_callback_handler,Timer Callback Handler>>
 
 [#onupdate_handler]
 === OnUpdate Handler
@@ -653,7 +664,7 @@ function OnUpdate(doc, meta) {
 }
 ----
 
-For more information about Timers, see xref:eventing-timers.adoc[].
+For more information about Timers, see xref:eventing-timers.adoc[Timers].
 
 
 == Reserved Words