From b80081f8a663db2650e548ec887c1af01fea07c3 Mon Sep 17 00:00:00 2001
From: Christopher Jones <christopher.jones@oracle.com>
Date: Thu, 16 Mar 2017 15:26:40 +1100
Subject: [PATCH] Add doc about manually tuning the statement cache size

---
 doc/api.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/doc/api.md b/doc/api.md
index c85cb52c..2e59e7cc 100644
--- a/doc/api.md
+++ b/doc/api.md
@@ -5582,6 +5582,12 @@ the [`createPool()`](#createpool) method.
 With Oracle Database 12c, the statement cache size can be automatically tuned with the
 [External Configuration](#oraaccess) *oraaccess.xml* file.
 
+To manually tune the statement cache size, monitor general application
+load and the [AWR](http://docs.oracle.com/database/122/TGDBA/gathering-database-statistics.htm#TGDBA168)
+"bytes sent via SQL*Net to client" values.  The latter statistic
+should benefit from not shipping statement metadata to node-oracledb.
+Adjust the statement cache size to your satisfaction.
+
 ## <a name="oraaccess"></a> 16. External Configuration
 
 When node-oracledb is linked with Oracle Database 12c client libraries, the Oracle