From f667c6faeaa6e3637b99a059b3aa906202b9a472 Mon Sep 17 00:00:00 2001
From: ZbyszekMM <zml@touk.pl>
Date: Mon, 4 May 2026 10:58:34 +0200
Subject: [PATCH] initial version

---
 docs/scenariosAuthoring/functionsAndMethods.md        | 9 +++++----
 docs/scenariosAuthoring/functionsAndMethodsListing.md | 7 ++++---
 2 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/docs/scenariosAuthoring/functionsAndMethods.md b/docs/scenariosAuthoring/functionsAndMethods.md
index 16ec863ffb5..83cd868badc 100644
--- a/docs/scenariosAuthoring/functionsAndMethods.md
+++ b/docs/scenariosAuthoring/functionsAndMethods.md
@@ -258,10 +258,11 @@ Some useful constants are also available:
 
 ### GEO - simple distance measurements
 
-- `#GEO.distanceInKm(Number,Number,Number,Number)` - calculate distance in km between two points (with decimal coordinates), using haversine algorithm
-- `#GEO.distanceInKm(pl.touk.nussknacker.engine.util.functions.Point,pl.touk.nussknacker.engine.util.functions.Point)` - calculate distance in km between two points (with decimal coordinates), using haversine algorithm
-- `#GEO.toPoint(Number,Number)` -> pl.touk.nussknacker.engine.util.functions.Point
-
+- `#GEO.azimuth(Number latitude1, Number longitude1, latitude2 Number, Number longitude2)` -> `Double` - calculate initial bearing (azimuth) in degrees from the first point to the second point. Result in range [0, 360).
+- `#GEO.closestPointOnLine(Number latitudeA, Number longitudeA, Number latitudeB, Number longitudeB, Number latitudeC, Number longitudeC)` -> `List[Double]` - calculate the closest point on the line segment AB to point C. Returns [latitude, longitude].
+- `#GEO.distanceInKm(Number latitude1, Number longitude1, Number latitude2, Number longitude2)` -> `Double` - calculate distance in km between two points (with decimal coordinates), using haversine algorithm
+- `#GEO.midpoint(Number latitude1, Number longitude1, Number latitude2, Number longitude2)` -> `List[Double]` - calculate geographic midpoint between two points on Earth. Returns [latitude, longitude].
+ 
 ### NUMERIC - number parsing
 
 - `#NUMERIC.abs(Number)` - returns the absolute value of a value.
diff --git a/docs/scenariosAuthoring/functionsAndMethodsListing.md b/docs/scenariosAuthoring/functionsAndMethodsListing.md
index 4dbc1b38e0c..52ae3d0cbff 100644
--- a/docs/scenariosAuthoring/functionsAndMethodsListing.md
+++ b/docs/scenariosAuthoring/functionsAndMethodsListing.md
@@ -9,7 +9,7 @@ keywords: ["functions", "methods", "SpEL", "expressions"]
 
 # Functions and Methods Listing
 
-<!-- This document is for Assistant only -->
+<!-- This document is for Assistant only - it is more more comprehensive that the document for humans, however more repetitive -->
 
 Functions and methods can be used in all [expression types](/docs/scenariosAuthoring/introduction.mdx#ways-of-providing-parameter-values) that support SpEL evaluation. 
 
@@ -127,9 +127,10 @@ Functions and methods can be used in all [expression types](/docs/scenariosAutho
 ```
 ### GEO
 ```
+.azimuth(Number latitude1, Number longitude1, latitude2 Number, Number longitude2)` -> Double - calculate initial bearing (azimuth) in degrees from the first point to the second point. Result in range [0, 360).
 .distanceInKm(Number,Number,Number,Number) -> Double - calculate distance in km between two points (with decimal coordinates), using haversine algorithm
-.distanceInKm(pl.touk.nussknacker.engine.util.functions.Point,pl.touk.nussknacker.engine.util.functions.Point) -> Double - calculate distance in km between two points (with decimal coordinates), using haversine algorithm
-.toPoint(Number,Number) -> pl.touk.nussknacker.engine.util.functions.Point
+.closestPointOnLine(Number latitudeA, Number longitudeA, Number latitudeB, Number longitudeB, Number latitudeC, Number longitudeC)` -> List[Double] - calculate the closest point on the line segment AB to point C. Returns [latitude, longitude].
+.midpoint(Number latitude1, Number longitude1, Number latitude2, Number longitude2)` -> List[Double] - calculate geographic midpoint between two points on Earth. Returns [latitude, longitude].
 ```
 ### NUMERIC
 ```