From fa8015e941cbd7d0dc04d0f656bcd3b2ce1c60cb Mon Sep 17 00:00:00 2001
From: Vincent Balat <vincent.balat@vblt.org>
Date: Thu, 21 Dec 2023 17:18:10 +0100
Subject: [PATCH] basics: small improvements

---
 tutos/7.1/manual/basics.wiki | 9 +++++----
 tutos/dev/manual/basics.wiki | 9 +++++----
 2 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/tutos/7.1/manual/basics.wiki b/tutos/7.1/manual/basics.wiki
index 851f4477..8b9d0233 100644
--- a/tutos/7.1/manual/basics.wiki
+++ b/tutos/7.1/manual/basics.wiki
@@ -509,7 +509,7 @@ This greatly simplifies communication between server and client.
 
 Pages can be generated either on the server or the client.
 The first HTTP request usually returns a server-side generated HTML page
-(thus indexable by search engines), but subsequent page generations are done
+(thus indexable by search engines), but subsequent page generations can be done
 by the client for better performance.
 In a mobile app, all pages are usually generated on the client.
 
@@ -547,7 +547,7 @@ Example:
   button ~a:[a_onclick [%client fun ev -> ... ]] [ ... ]
 >>
 
-The syntax is {{{[%client (<value> : <type>) }}}.
+The syntax is {{{[%client (<value> : <type>)]}}}.
 Type annotation is almost always required.
 
 These client fragments can be manipulated as server side OCaml values:
@@ -562,7 +562,7 @@ If such section is reached while generating a page on client side,
 the client-side code will be executed immediately
 (In that case, you can delay the execution, if needed,
 for example with function
-<<a_api project="ocsigen-toolkit" subproject="client"|val Ot_nodeready.nodeready>>).
+<<a_api project="ocsigen-toolkit" subproject="client"|val Ot_nodeready.nodeready>> to wait for the element to be actually displayed).
 
 If such section is reached during module initialization on the server
 (global client section), it will be executed on client side everytime
@@ -618,7 +618,8 @@ server-side program and also inserted in the generated page.
 
 ===Example===
 This section shows a typical example of client-server code: call a function
-when user clicks on a page element.
+when user clicks on a page element. Take time to analyse this example,
+as most of your code will probably be very similar.
 
 <<code language="ocaml" class="client"|
 open%client Js_of_ocaml
diff --git a/tutos/dev/manual/basics.wiki b/tutos/dev/manual/basics.wiki
index 851f4477..8b9d0233 100644
--- a/tutos/dev/manual/basics.wiki
+++ b/tutos/dev/manual/basics.wiki
@@ -509,7 +509,7 @@ This greatly simplifies communication between server and client.
 
 Pages can be generated either on the server or the client.
 The first HTTP request usually returns a server-side generated HTML page
-(thus indexable by search engines), but subsequent page generations are done
+(thus indexable by search engines), but subsequent page generations can be done
 by the client for better performance.
 In a mobile app, all pages are usually generated on the client.
 
@@ -547,7 +547,7 @@ Example:
   button ~a:[a_onclick [%client fun ev -> ... ]] [ ... ]
 >>
 
-The syntax is {{{[%client (<value> : <type>) }}}.
+The syntax is {{{[%client (<value> : <type>)]}}}.
 Type annotation is almost always required.
 
 These client fragments can be manipulated as server side OCaml values:
@@ -562,7 +562,7 @@ If such section is reached while generating a page on client side,
 the client-side code will be executed immediately
 (In that case, you can delay the execution, if needed,
 for example with function
-<<a_api project="ocsigen-toolkit" subproject="client"|val Ot_nodeready.nodeready>>).
+<<a_api project="ocsigen-toolkit" subproject="client"|val Ot_nodeready.nodeready>> to wait for the element to be actually displayed).
 
 If such section is reached during module initialization on the server
 (global client section), it will be executed on client side everytime
@@ -618,7 +618,8 @@ server-side program and also inserted in the generated page.
 
 ===Example===
 This section shows a typical example of client-server code: call a function
-when user clicks on a page element.
+when user clicks on a page element. Take time to analyse this example,
+as most of your code will probably be very similar.
 
 <<code language="ocaml" class="client"|
 open%client Js_of_ocaml