From b95fb0d8fb667bd1be74b5359edb5c421c422cc3 Mon Sep 17 00:00:00 2001
From: Ali Jahangiri <75624145+aliphys@users.noreply.github.com>
Date: Mon, 10 Jun 2024 17:15:57 +0200
Subject: [PATCH 1/2] docs: clarify paragraph value

---
 library.properties | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/library.properties b/library.properties
index ab78b34..62e8ea6 100644
--- a/library.properties
+++ b/library.properties
@@ -2,8 +2,8 @@ name=Arduino_GigaDisplayTouch
 version=1.0.1
 author=Arduino
 maintainer=Arduino <info@arduino.cc>
-sentence=Touch library for Arduino Giga Display Shield
-paragraph=The Arduino Giga Display Touch library is a C++ library designed to manage the touch controller of the Giga Display Shield. It is currently compatible with Goodix GT911 5-point Capacitive touch controller. This library captures up to 5 concurrent touch points using two approaches: by interrupt or on-request.
+sentence=Touch library for Arduino GIGA Display Shield
+paragraph=Easily use the touch features of the Arduino GIGA Display Shield (ASX00039), provided via the Goodix GT911 5-point Capacitive touch controller. Capture up to 5 concurrent touch points using two approaches: by interrupt (IRQ) or on-request (polling).
 category=Sensors
 url=https://github.com/arduino-libraries/Arduino_GigaDisplayTouch
 architectures=mbed,mbed_portenta,mbed_giga

From ae078b80d0a9098a973da1945c071150d39bf9a7 Mon Sep 17 00:00:00 2001
From: Ali Jahangiri <75624145+aliphys@users.noreply.github.com>
Date: Mon, 10 Jun 2024 17:16:12 +0200
Subject: [PATCH 2/2] docs: add header comment to examples

---
 examples/Touch_IRQ/Touch_IRQ.ino         | 24 ++++++++++++++++++------
 examples/Touch_Polling/Touch_Polling.ino | 24 ++++++++++++++++++------
 2 files changed, 36 insertions(+), 12 deletions(-)

diff --git a/examples/Touch_IRQ/Touch_IRQ.ino b/examples/Touch_IRQ/Touch_IRQ.ino
index 840addd..f4e0649 100644
--- a/examples/Touch_IRQ/Touch_IRQ.ino
+++ b/examples/Touch_IRQ/Touch_IRQ.ino
@@ -1,9 +1,21 @@
-/*
-  Touch_IRQ
-
-  created 03 May 2023
-  by Leonardo Cavagnis
-*/
+/* 
+ * Touch_IRQ.ino
+ * 
+ * This example shows how to get the number of points and the coordinates of the first touch points detected by the touch controller using interrupts.
+ * 
+ * The setup() function initializes the serial communication and the touch controller. Whenever a touch event is detcted, the gigaTouchHandler function is called that prints the number of points and first touch co-ordinates to the Serial Monitor. The loop() function is empty because the touch controller is configured to work with interrupts. 
+ * 
+ * For the polling version of this example, see Touch_Polling.ino
+ * 
+ * Instructions:
+ * 1. Connect your GIGA Display Shield (ASX00039) to a GIGA R1 WiFi (ABX00063) board .
+ * 2. Upload this sketch to your board.
+ * 3. Open the Serial Monitor.
+ * 4. Touch the screen with your finger(s) and view the coordinates printed on the Serial Monitor.
+ * 
+ * Initial author: Leonardo Cavagnis @leonardocavagnis
+ * Created: 03 May 2023
+ */
 
 #include "Arduino_GigaDisplayTouch.h"
 
diff --git a/examples/Touch_Polling/Touch_Polling.ino b/examples/Touch_Polling/Touch_Polling.ino
index 217da19..6d6b081 100644
--- a/examples/Touch_Polling/Touch_Polling.ino
+++ b/examples/Touch_Polling/Touch_Polling.ino
@@ -1,9 +1,21 @@
-/*
-  Touch_Polling
-
-  created 03 May 2023
-  by Leonardo Cavagnis
-*/
+/* 
+ * Touch_Polling.ino
+ * 
+ * This example shows how to get the number of points and the coordinates of the first touch points detected by the touch controller using polling.
+ * 
+ * The setup() function initializes the serial communication and the touch controller. The loop() function continuously checks to see if a touch event is detected. Whenever a touch event is detcted, that prints the number of points and first touch co-ordinates to the Serial Monitor.
+ * 
+ * For the interrupt version of this example, see Touch_IRQ.ino
+ * 
+ * Instructions:
+ * 1. Connect your GIGA Display Shield (ASX00039) to a GIGA R1 WiFi (ABX00063) board .
+ * 2. Upload this sketch to your board.
+ * 3. Open the Serial Monitor.
+ * 4. Touch the screen with your finger(s) and view the coordinates printed on the Serial Monitor.
+ * 
+ * Initial author: Leonardo Cavagnis @leonardocavagnis
+ * Created: 03 May 2023
+ */
 
 #include "Arduino_GigaDisplayTouch.h"