From 38e2ab511cb40e4a76855443f34dc7208d10de27 Mon Sep 17 00:00:00 2001
From: Harsh <harshmastic@gmail.com>
Date: Tue, 14 Oct 2025 00:11:45 +0530
Subject: [PATCH] Enhance documentation for textOutput and gridOutput methods

---
 src/accessibility/outputs.js | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/src/accessibility/outputs.js b/src/accessibility/outputs.js
index 38ba679e38..3dde5a2440 100644
--- a/src/accessibility/outputs.js
+++ b/src/accessibility/outputs.js
@@ -37,6 +37,15 @@ import p5 from '../core/main';
  * <a href="https://p5js.org/tutorials/writing-accessible-canvas-descriptions/">Writing accessible canvas descriptions</a>
  * to learn more about making sketches accessible.
  *
+ * `textOutput()` generates descriptions in English only. Text drawn with
+ * <a href="#/p5/text">text()</a> is not described. Shapes created with
+ * <a href="#/p5/beginShape">beginShape()</a> are not described. WEBGL mode
+ * and 3D shapes are not supported.
+ *
+ * Use <a href="#/p5/describe">describe()</a> and
+ * <a href="#/p5/describeElement">describeElement()</a> for more control
+ * over canvas descriptions.
+ *
  * @method textOutput
  * @param  {Constant} [display] either FALLBACK or LABEL.
  *
@@ -172,6 +181,15 @@ p5.prototype.textOutput = function(display) {
  * <a href="https://p5js.org/tutorials/writing-accessible-canvas-descriptions/">Writing accessible canvas descriptions</a>
  * to learn more about making sketches accessible.
  *
+ * `gridOutput()` generates descriptions in English only. Text drawn with
+ * <a href="#/p5/text">text()</a> is not described. Shapes created with
+ * <a href="#/p5/beginShape">beginShape()</a> are not described. WEBGL mode
+ * and 3D shapes are not supported.
+ *
+ * Use <a href="#/p5/describe">describe()</a> and
+ * <a href="#/p5/describeElement">describeElement()</a> for more control
+ * over canvas descriptions.
+ *
  * @method gridOutput
  * @param  {Constant} [display] either FALLBACK or LABEL.
  *