README history and versioning; describe SqlMap as an iBATIS.NET DataMapper port

CHANGELOG.md

@@ -6,7 +6,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
-First standalone release. SqlMap moves out of the PRADO framework (`framework/Data/SqlMap`) into this package. Namespaces and class names are unchanged. The baseline is the framework copy in PRADO `master` at commit `2c7e90da` (2026-10-21), including every SqlMap fix made there through pradosoft/prado#1330. The entries below are differences from that baseline. See the [migration guide](docs/migration.md) for upgrade steps.
+First standalone release, planned as 1.0.0, for PRADO 4.4. SqlMap moves out of the PRADO framework (`framework/Data/SqlMap`) into this package. Namespaces and class names are unchanged. The baseline is the framework copy in PRADO `master` at commit `2c7e90da` (2026-10-21), including every SqlMap fix made there through pradosoft/prado#1330. The entries below are differences from that baseline. See the [migration guide](docs/migration.md) for upgrade steps.
 
 ### Added
 

README.md

@@ -2,7 +2,7 @@
 
 SqlMap Data Mapper extension for the [PRADO PHP Framework](https://github.com/pradosoft/prado).
 
-SqlMap maps SQL statements to PHP objects using XML configuration files. Queries, inserts, updates, and deletes are defined in XML; the gateway executes them and maps result rows to objects or arrays automatically. prado-sqlmap implements the iBATIS SQL Maps 2 specification; [MyBATIS](https://mybatis.org) is the actively maintained successor with extensive reference documentation.
+SqlMap maps SQL statements to PHP objects using XML configuration files. Queries, inserts, updates, and deletes are defined in XML; the gateway executes them and maps result rows to objects or arrays automatically. prado-sqlmap is a PHP port of the iBATIS DataMapper (SQL Maps 2), whose Java line continues today as [MyBatis](https://github.com/mybatis/mybatis-3). The MyBatis documentation is a useful reference for the shared concepts. See [History](#history).
 
 ## Requirements
 
@@ -898,6 +898,14 @@ src/Data/SqlMap/
 → `TResultMap` property mapping
 → returned object
 
+## History
+
+Clinton Begin started iBATIS in 2001, and its SQL Maps component (2002) mapped SQL kept in XML files to Java objects. iBATIS 2.0 shipped in June 2004, and the project moved to the Apache Software Foundation, where a C# edition, iBATIS.NET DataMapper, was also developed. Wei Zhuo ported iBATIS.NET DataMapper to PHP for PRADO in April 2006, and it first shipped as SQLMap in PRADO 3.1.0 (alpha, January 15, 2007). In May 2010 the iBATIS team published iBATIS 3.0 and continued development under the name MyBatis on Google Code. Apache retired iBATIS to the Apache Attic in June 2010. MyBatis moved to GitHub in November 2013 and is maintained at [mybatis/mybatis-3](https://github.com/mybatis/mybatis-3). PRADO's SqlMap stayed in the framework through PRADO 4.3 and moved to this package for PRADO 4.4 in 2026.
+
+## Versioning
+
+The package has its own version line, starting at 1.0.0, independent of the PRADO framework version. The first release pairs with PRADO 4.4, the release that removes SqlMap from the framework. Point releases stay backward compatible. Changes are listed in the [changelog](CHANGELOG.md).
+
 ## License
 
 BSD-3-Clause. See [LICENSE](LICENSE).

docs/README.md

@@ -2,7 +2,7 @@
 
 # SqlMap Documentation
 
-SqlMap is a data-mapper layer that maps SQL statements defined in XML files to PHP objects. It originated in the Java iBATIS project and provides a clean separation between SQL and application code by keeping all queries in XML mapping files rather than embedded in PHP. [MyBATIS](https://mybatis.org/mybatis-3/) is the current actively maintained successor to iBATIS. This library covers the PRADO PHP framework implementation of the SqlMap pattern.
+SqlMap is a data-mapper layer that maps SQL statements defined in XML files to PHP objects. It is a PHP port of iBATIS.NET DataMapper, the C# edition of the Java iBATIS project, and provides a clean separation between SQL and application code by keeping all queries in XML mapping files rather than embedded in PHP. [MyBATIS](https://mybatis.org/mybatis-3/) is the current actively maintained successor to iBATIS. This library covers the PRADO PHP framework implementation of the SqlMap pattern.
 
 ## Contents