From 1f4bef87a67389bbc52ec9fa90cb016c0c5ad387 Mon Sep 17 00:00:00 2001
From: Isaque Borges <izzybps@gmail.com>
Date: Thu, 25 Jul 2024 20:02:45 -0300
Subject: [PATCH] Fixing boolean-intersects docs (#2593)

* Improve boolean-intersects docs

* Improving boolean-intersects docs

* adding boolean-intersects to documentation.yml

* moved addtomap to end and colored markers

---------

Co-authored-by: James Beard <james@smallsaucepan.com>
---
 CHANGELOG.md                               |  2 +-
 documentation.yml                          |  1 +
 packages/turf-boolean-intersects/README.md | 17 +++++++++++++----
 packages/turf-boolean-intersects/index.ts  | 17 +++++++++++++----
 4 files changed, 28 insertions(+), 9 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3329fd3a2e..f748f74e47 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -64,7 +64,7 @@ Changelog is no longer maintained. See Turf Github [releases](https://github.com
 - [`@turf/polygon-smooth`](polygon-smooth) Clean up a typo (#2293)
 - [`@turf/nearest-point-on-line`](nearest-point-on-line) Clean up typescript types (#2296)
 - [`@turf/boolean-touches`](boolean-touches) Add boolean-touches to docs (#2431)
-- [`@turf/boolean-equals`](boolean-equals) Improve docs (#2412)
+- [`@turf/boolean-equal`](boolean-equal) Improve docs (#2412)
 
 - Remove Bower references (#2146)
 - Fix typo in README (#2313)
diff --git a/documentation.yml b/documentation.yml
index 671d6b5722..f94a53e42e 100644
--- a/documentation.yml
+++ b/documentation.yml
@@ -139,6 +139,7 @@ toc:
   - booleanCrosses
   - booleanDisjoint
   - booleanEqual
+  - booleanIntersects
   - booleanOverlap
   - booleanParallel
   - booleanPointInPolygon
diff --git a/packages/turf-boolean-intersects/README.md b/packages/turf-boolean-intersects/README.md
index b6f0c74fd1..3bcf5cc5b9 100644
--- a/packages/turf-boolean-intersects/README.md
+++ b/packages/turf-boolean-intersects/README.md
@@ -4,7 +4,7 @@
 
 ## booleanIntersects
 
-Boolean-intersects returns (TRUE) two geometries intersect.
+Boolean-intersects returns (TRUE) if the intersection of the two geometries is NOT an empty set.
 
 ### Parameters
 
@@ -14,11 +14,20 @@ Boolean-intersects returns (TRUE) two geometries intersect.
 ### Examples
 
 ```javascript
-var point = turf.point([2, 2]);
-var line = turf.lineString([[1, 1], [1, 2], [1, 3], [1, 4]]);
+var point1 = turf.point([2, 2]);
+var point2 = turf.point([1, 2]);
+var line = turf.lineString([[1, 1], [1, 3], [1, 4]]);
 
-turf.booleanIntersects(line, point);
+turf.booleanIntersects(line, point1);
+//=false
+
+turf.booleanIntersects(line, point2);
 //=true
+
+//addToMap
+var addToMap = [point1, point2, line];
+point1.properties['marker-color'] = '#f00'
+point2.properties['marker-color'] = '#0f0'
 ```
 
 Returns **[boolean][3]** true/false
diff --git a/packages/turf-boolean-intersects/index.ts b/packages/turf-boolean-intersects/index.ts
index 2f2ba1d1d2..ceb1ae006c 100644
--- a/packages/turf-boolean-intersects/index.ts
+++ b/packages/turf-boolean-intersects/index.ts
@@ -3,18 +3,27 @@ import { booleanDisjoint } from "@turf/boolean-disjoint";
 import { flattenEach } from "@turf/meta";
 
 /**
- * Boolean-intersects returns (TRUE) two geometries intersect.
+ * Boolean-intersects returns (TRUE) if the intersection of the two geometries is NOT an empty set.
  *
  * @name booleanIntersects
  * @param {Geometry|Feature<any>} feature1 GeoJSON Feature or Geometry
  * @param {Geometry|Feature<any>} feature2 GeoJSON Feature or Geometry
  * @returns {boolean} true/false
  * @example
- * var point = turf.point([2, 2]);
- * var line = turf.lineString([[1, 1], [1, 2], [1, 3], [1, 4]]);
+ * var point1 = turf.point([2, 2]);
+ * var point2 = turf.point([1, 2]);
+ * var line = turf.lineString([[1, 1], [1, 3], [1, 4]]);
  *
- * turf.booleanIntersects(line, point);
+ * turf.booleanIntersects(line, point1);
+ * //=false
+ *
+ * turf.booleanIntersects(line, point2);
  * //=true
+ *
+ * //addToMap
+ * var addToMap = [point1, point2, line];
+ * point1.properties['marker-color'] = '#f00'
+ * point2.properties['marker-color'] = '#0f0'
  */
 function booleanIntersects(
   feature1: Feature<any> | Geometry,