docs: add upstream source attribution for geo::algorithm::area and update LICENSE

Kontinuation · Kontinuation · commit 8383741e7069 · 2025-10-09T14:10:40.000+08:00
docs: add upstream geo source attribution to remaining generic algorithms

docs: add upstream geo source attribution to remaining line_measures modules

docs: add upstream geo source attribution to intersects submodules and algorithm mod

docs: add upstream geo attribution to geometry, lib, and utils modules

license
diff --git a/LICENSE b/LICENSE
@@ -212,6 +212,7 @@ c/sedona-geoarrow-c/src/geoarrow (vendored from https://github.com/geoarrow/geoa
 c/sedona-geoarrow-c/src/nanoarrow (vendored from https://github.com/apache/arrow-nanoarrow)
 c/sedona-s2geography/s2geography (submodule from https://github.com/paleolimbot/s2geography)
 c/sedona-s2geography/s2geometry (submodule from https://github.com/google/s2geometry)
+rust/sedona-geo-generic-alg (ported and contains copied code from https://github.com/georust/geo)
 
 MIT License
 --------------------------------------
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/area.rs b/rust/sedona-geo-generic-alg/src/algorithm/area.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Generic Area algorithm
+//!
+//! Ported (and contains copied code) from `geo::algorithm::area`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/area.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use sedona_geo_traits_ext::*;
 
 use crate::{CoordFloat, CoordNum};
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/bounding_rect.rs b/rust/sedona-geo-generic-alg/src/algorithm/bounding_rect.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Generic Bounding Rectangle algorithm
+//!
+//! Ported (and contains copied code) from `geo::algorithm::bounding_rect`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/bounding_rect.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use crate::utils::{partial_max, partial_min};
 use crate::{coord, geometry::*, CoordNum};
 use core::borrow::Borrow;
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/centroid.rs b/rust/sedona-geo-generic-alg/src/algorithm/centroid.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Generic Centroid algorithm
+//!
+//! Ported (and contains copied code) from `geo::algorithm::centroid`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/centroid.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use core::borrow::Borrow;
 use std::cmp::Ordering;
 
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/coordinate_position.rs b/rust/sedona-geo-generic-alg/src/algorithm/coordinate_position.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Generic Coordinate Position algorithm
+//!
+//! Ported (and contains copied code) from `geo::algorithm::coordinate_position`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/coordinate_position.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use core::borrow::Borrow;
 use std::cmp::Ordering;
 
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/dimensions.rs b/rust/sedona-geo-generic-alg/src/algorithm/dimensions.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Generic Dimensions (HasDimensions) algorithm
+//!
+//! Ported (and contains copied code) from `geo::algorithm::dimensions`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/dimensions.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use core::borrow::Borrow;
 use sedona_geo_traits_ext::*;
 
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/euclidean_length.rs b/rust/sedona-geo-generic-alg/src/algorithm/euclidean_length.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Generic Euclidean Length algorithm
+//!
+//! Ported (and contains copied code) from `geo::algorithm::euclidean_length`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/euclidean_length.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use core::borrow::Borrow;
 use std::iter::Sum;
 
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/intersects/collections.rs b/rust/sedona-geo-generic-alg/src/algorithm/intersects/collections.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Intersects implementations for Geometry and GeometryCollection (generic)
+//!
+//! Ported (and contains copied code) from `geo::algorithm::intersects::collections`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/intersects/collections.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use core::borrow::Borrow;
 use sedona_geo_traits_ext::*;
 
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/intersects/coordinate.rs b/rust/sedona-geo-generic-alg/src/algorithm/intersects/coordinate.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Intersects implementations for Coord and Point (generic)
+//!
+//! Ported (and contains copied code) from `geo::algorithm::intersects::coordinate`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/intersects/coordinate.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use sedona_geo_traits_ext::{CoordTag, CoordTraitExt, PointTag, PointTraitExt};
 
 use super::IntersectsTrait;
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/intersects/line.rs b/rust/sedona-geo-generic-alg/src/algorithm/intersects/line.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Intersects implementations for Line (generic)
+//!
+//! Ported (and contains copied code) from `geo::algorithm::intersects::line`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/intersects/line.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use sedona_geo_traits_ext::*;
 
 use super::{point_in_rect, IntersectsTrait};
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/intersects/line_string.rs b/rust/sedona-geo-generic-alg/src/algorithm/intersects/line_string.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Intersects implementations for LineString and MultiLineString (generic)
+//!
+//! Ported (and contains copied code) from `geo::algorithm::intersects::line_string`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/intersects/line_string.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use sedona_geo_traits_ext::*;
 
 use super::{has_disjoint_bboxes, IntersectsTrait};
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/intersects/mod.rs b/rust/sedona-geo-generic-alg/src/algorithm/intersects/mod.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Generic Intersects algorithm
+//!
+//! Ported (and contains copied code) from `geo::algorithm::intersects` (and its submodules):
+//! <https://github.com/georust/geo/tree/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/intersects>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use sedona_geo_traits_ext::GeoTraitExtWithTypeTag;
 
 use crate::BoundingRect;
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/intersects/point.rs b/rust/sedona-geo-generic-alg/src/algorithm/intersects/point.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Intersects implementations for Point and MultiPoint (generic)
+//!
+//! Ported (and contains copied code) from `geo::algorithm::intersects::point`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/intersects/point.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use sedona_geo_traits_ext::*;
 
 use super::IntersectsTrait;
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/intersects/polygon.rs b/rust/sedona-geo-generic-alg/src/algorithm/intersects/polygon.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Intersects implementations for Polygon and MultiPolygon (generic)
+//!
+//! Ported (and contains copied code) from `geo::algorithm::intersects::polygon`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/intersects/polygon.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use super::{has_disjoint_bboxes, IntersectsTrait};
 use crate::coordinate_position::CoordPos;
 use crate::CoordinatePosition;
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/intersects/rect.rs b/rust/sedona-geo-generic-alg/src/algorithm/intersects/rect.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Intersects implementations for Rect (generic)
+//!
+//! Ported (and contains copied code) from `geo::algorithm::intersects::rect`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/intersects/rect.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use geo_traits::CoordTrait;
 use sedona_geo_traits_ext::*;
 
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/intersects/triangle.rs b/rust/sedona-geo-generic-alg/src/algorithm/intersects/triangle.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Intersects implementations for Triangle (generic)
+//!
+//! Ported (and contains copied code) from `geo::algorithm::intersects::triangle`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/intersects/triangle.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use super::IntersectsTrait;
 use crate::*;
 use sedona_geo_traits_ext::*;
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/kernels/mod.rs b/rust/sedona-geo-generic-alg/src/algorithm/kernels/mod.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Generic Kernel predicates (orientation, distance, dot product)
+//!
+//! Ported (and contains copied code) from `geo::algorithm::kernels`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/kernels/mod.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use num_traits::Zero;
 
 use crate::{coord, Coord, CoordNum};
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/kernels/robust.rs b/rust/sedona-geo-generic-alg/src/algorithm/kernels/robust.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Robust kernel predicates (orientation using robust predicates)
+//!
+//! Ported (and contains copied code) from `geo::algorithm::kernels::robust`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/kernels/robust.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use super::{CoordNum, Kernel, Orientation};
 use crate::Coord;
 
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/kernels/simple.rs b/rust/sedona-geo-generic-alg/src/algorithm/kernels/simple.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Simple kernel predicates
+//!
+//! Ported (and contains copied code) from `geo::algorithm::kernels::simple`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/kernels/simple.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use super::Kernel;
 use crate::CoordNum;
 
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/line_measures/distance.rs b/rust/sedona-geo-generic-alg/src/algorithm/line_measures/distance.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Generic Distance traits (line measures)
+//!
+//! Ported (and contains copied code) from `geo::algorithm::line_measures::distance`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/line_measures/distance.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 /// Calculate the minimum distance between two geometries.
 pub trait Distance<F, Origin, Destination> {
     /// Note that not all implementations support all geometry combinations, but at least `Point` to `Point`
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/line_measures/length.rs b/rust/sedona-geo-generic-alg/src/algorithm/line_measures/length.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Generic Length and Perimeter extension traits
+//!
+//! Ported (and contains copied code) from `geo::algorithm::line_measures::length` (and related perimeter logic):
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/line_measures/length.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use super::Distance;
 use crate::{CoordFloat, Point};
 use geo_traits::{CoordTrait, PolygonTrait};
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/line_measures/metric_spaces/euclidean/distance.rs b/rust/sedona-geo-generic-alg/src/algorithm/line_measures/metric_spaces/euclidean/distance.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Euclidean DistanceExt generic implementation
+//!
+//! Ported (and contains copied code) from `geo::algorithm::line_measures::metric_spaces::euclidean::distance`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/line_measures/metric_spaces/euclidean/distance.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use crate::{CoordFloat, GeoFloat, Point};
 use num_traits::{Bounded, Float};
 use std::borrow::Borrow;
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/line_measures/metric_spaces/euclidean/mod.rs b/rust/sedona-geo-generic-alg/src/algorithm/line_measures/metric_spaces/euclidean/mod.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Euclidean metric space implementations (generic)
+//!
+//! Ported (and contains copied code) from `geo::algorithm::line_measures::metric_spaces::euclidean`:
+//! <https://github.com/georust/geo/tree/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/line_measures/metric_spaces/euclidean>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 mod distance;
 mod utils;
 pub use distance::DistanceExt;
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/line_measures/metric_spaces/euclidean/utils.rs b/rust/sedona-geo-generic-alg/src/algorithm/line_measures/metric_spaces/euclidean/utils.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Euclidean distance helper utilities (generic)
+//!
+//! Ported (and contains copied code) from `geo::algorithm::line_measures::metric_spaces::euclidean::utils`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/line_measures/metric_spaces/euclidean/utils.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 use crate::algorithm::Intersects;
 use crate::coordinate_position::{coord_pos_relative_to_ring, CoordPos};
 use crate::geometry::*;
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/line_measures/metric_spaces/mod.rs b/rust/sedona-geo-generic-alg/src/algorithm/line_measures/metric_spaces/mod.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Generic Metric Spaces (currently Euclidean)
+//!
+//! Ported (and contains copied code) from `geo::algorithm::line_measures::metric_spaces`:
+//! <https://github.com/georust/geo/tree/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/line_measures/metric_spaces>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 pub mod euclidean;
 pub use euclidean::DistanceExt;
 pub use euclidean::Euclidean;
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/line_measures/mod.rs b/rust/sedona-geo-generic-alg/src/algorithm/line_measures/mod.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Generic line measurement algorithms (distance, length, perimeter, metric spaces)
+//!
+//! Ported (and contains copied code) from `geo::algorithm::line_measures` and related modules:
+//! <https://github.com/georust/geo/tree/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/line_measures>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 mod distance;
 pub use distance::{Distance, DistanceExt};
 
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/map_coords.rs b/rust/sedona-geo-generic-alg/src/algorithm/map_coords.rs
@@ -14,6 +14,11 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Generic Map Coords algorithm
+//!
+//! Ported (and contains copied code) from `geo::algorithm::map_coords`:
+//! <https://github.com/georust/geo/blob/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm/map_coords.rs>.
+//! Original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 pub(crate) use crate::geometry::*;
 pub(crate) use crate::CoordNum;
 
diff --git a/rust/sedona-geo-generic-alg/src/algorithm/mod.rs b/rust/sedona-geo-generic-alg/src/algorithm/mod.rs
@@ -14,6 +14,12 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Collection of generic geometry algorithms ported from the `geo` crate.
+//!
+//! All submodules in this directory are ported (and contain copied code) from the
+//! `geo` crate at commit `5d667f844716a3d0a17aa60bc0a58528cb5808c3`:
+//! <https://github.com/georust/geo/tree/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src/algorithm>.
+//! The original code is dual-licensed under Apache-2.0 or MIT; used here under Apache-2.0.
 /// Kernels to compute various predicates
 pub mod kernels;
 pub use kernels::{Kernel, Orientation};
diff --git a/rust/sedona-geo-generic-alg/src/geometry.rs b/rust/sedona-geo-generic-alg/src/geometry.rs
@@ -14,5 +14,13 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Geometry type re-exports
+//!
+//! Ported (and contains copied code pattern) from the `geo` crate (geometry module) at commit
+//! `5d667f844716a3d0a17aa60bc0a58528cb5808c3`:
+//! <https://github.com/georust/geo/tree/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src>.
+//! This file is a thin wrapper that publicly re-exports geometry types from `geo-types` to
+//! mirror the upstream API surface. Original upstream code is dual-licensed under Apache-2.0 or MIT;
+//! used here under Apache-2.0.
 //! This module makes all geometry types available
 pub use geo_types::geometry::*;
diff --git a/rust/sedona-geo-generic-alg/src/lib.rs b/rust/sedona-geo-generic-alg/src/lib.rs
@@ -14,6 +14,15 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+//! Crate root for generic geometry algorithms ported from `geo`.
+//!
+//! Substantial portions of this crate (algorithm modules, trait patterns, and API surface) are
+//! ported (and contain copied code) from the `geo` crate at commit
+//! `5d667f844716a3d0a17aa60bc0a58528cb5808c3`:
+//! <https://github.com/georust/geo/tree/5d667f844716a3d0a17aa60bc0a58528cb5808c3/geo/src>.
+//! The original upstream project is dual-licensed under Apache-2.0 or MIT; the copied/ported code
+//! here is used under the Apache-2.0 license consistent with this repository.
+//! This top-level file orchestrates module exposure and numeric traits mirroring upstream design.
 #[cfg(feature = "use-serde")]
 #[macro_use]
 extern crate serde;
diff --git a/rust/sedona-geo-generic-alg/src/utils.rs b/rust/sedona-geo-generic-alg/src/utils.rs
@@ -15,6 +15,12 @@
 // specific language governing permissions and limitations
 // under the License.
 //! Internal utility functions, types, and data structures.
+//!
+//! Some helper logic (naming / minimal patterns) corresponds to simple utilities present in the
+//! upstream `geo` crate at commit `5d667f844716a3d0a17aa60bc0a58528cb5808c3`.
+//! (Example: partial_min / partial_max helpers). Where identical or trivially adapted, they are
+//! used here under the upstream dual-license (Apache-2.0 or MIT); incorporated under Apache-2.0.
+//! Upstream repository: <https://github.com/georust/geo>.
 
 // The Rust standard library has `max` for `Ord`, but not for `PartialOrd`
 pub fn partial_max<T: PartialOrd>(a: T, b: T) -> T {
