GEOS-6711: added some documentation for the improvements