Add upgrading doc

Author: cjbj

INSTALL.md

@@ -1998,12 +1998,10 @@ Issues and questions about node-oracledb can be posted on [GitHub][10] or
 [31]: https://www.oracle.com/database/technologies/instant-client/solx8664-downloads.html
 [40]: https://github.com/oracle/node-oracledb/tags
 [41]: https://github.com/oracle/node-oracledb/releases
-[42]: https://oracle.github.io/node-oracledb/doc/api.html#migratev1v2
 [43]: https://github.com/oracle/node-oracledb/blob/main/CHANGELOG.md
 [44]: https://oracle.github.io/node-oracledb/doc/api.html
 [45]: https://www.youtube.com/watch?v=WDJacg0NuLo
 [46]: https://yum.oracle.com/oracle-linux-nodejs.html
-[47]: https://oracle.github.io/node-oracledb/doc/api.html#migrate
 [48]: https://node-oracledb.slack.com/
 [49]: https://join.slack.com/t/node-oracledb/shared_invite/enQtNDU4Mjc2NzM5OTA2LWMzY2ZlZDY5MDdlMGZiMGRkY2IzYjI5OGU4YTEzZWM5YjQ3ODUzMjcxNWQyNzE4MzM5YjNkYjVmNDk5OWU5NDM
 [50]: https://yum.oracle.com/repo/OracleLinux/OL6/oracle/instantclient/x86_64/index.html

doc/api.md

@@ -27,7 +27,7 @@ This document contains:
 
 For installation information, see the [Node-oracledb Installation Instructions][2].
 
-##  <a name="contents"></a> Contents
+## <a name="contents"></a> Contents
 
 1. [Introduction](#intro)
     - 1.1 [Node-oracledb Architecture](#architecture)
@@ -550,6 +550,7 @@ For installation information, see the [Node-oracledb Installation Instructions][
     - 34.2 [Migrating from node-oracledb 4.0 to node-oracledb 4.1](#migratev40v41)
     - 34.3 [Migrating from node-oracledb 4.1 to node-oracledb 4.2](#migratev41v42)
     - 34.4 [Migrating from node-oracledb 4.2 to node-oracledb 5.0](#migratev42v50)
+    - 34.5 [Migrating from node-oracledb 5.1 to node-oracledb 5.2](#migratev51v52)
 35. [Useful Resources for Node-oracledb](#otherresources)
 
 ## <a name="apimanual"></a> NODE-ORACLEDB API MANUAL
@@ -17259,6 +17260,18 @@ When upgrading from node-oracledb version 4.0 to version 4.1:
   if one is used.  In earlier versions they were thrown without the ability for
   them to be caught.
 
+### <a name="migratev51v52"></a> 34.5 Migrating from node-oracledb 5.1 to node-oracledb 5.2
+
+- Review the [CHANGELOG][83] and take advantage of new features.
+
+- Review the dead connection detection changes and adjust any application error
+  checks to look for the new error *DPI-1080*.
+
+- Replace obsolete uses of `_enableStats` and `_logStats()` with the new
+  functionality [`enableStatistics`](#createpoolpoolattrsstats),
+  [`getStatistics()`](#poolgetstatistics), and
+  [`logStatistics()`](#poollogstatistics).
+
 ## <a name="otherresources"></a> 35. Useful Resources for Node-oracledb
 
 Node-oracledb can be installed on the pre-built [*Database App Development