update API docs

Author: mlynch

packages/website/docs/configuration-tool.md

@@ -222,6 +222,8 @@ The operation supports inserting arbitrary Gradle code, or when using `replace`,
 The Gradle commands supports two modes: `insert` or `replace`:
 
 - `insert` inserts new Gradle snippets at the desired location in the file
+  - This operation takes either a raw string of Groovy-based Gradle, or an object. When using the object, make sure to set the `insertType` (see next line) to ensure the correct code is generated.
+  - This operation takes an `insertType` of either `'method'` (default) or `'variable'` which will create either a method call (`methodName methodArg`) or an assignment (`variable = value`).
 - `replace` replaces existing entries in the Gradle file at the desired location
 
 Currently, the tool supports updating primitive types (numbers, strings, booleans), and arrays of primitives. Strings need additional quoting if necessary, in order to support non-quoted variable strings. See the example below for string quoting examples.
@@ -246,6 +248,13 @@ platforms:
               - url: 'https://pkgs.dev.azure.com/MicrosoftDeviceSDK/DuoSDK-Public/_packaging/Duo-SDK-Feed/maven/v1'
               - name: 'Duo-SDK-Feed'
 
+      - file: variables.gradle
+        target:
+          ext:
+        insertType: 'variable'
+        insert:
+          - firebaseMessagingVersion: '20.0.6'
+
       - file: app/build.gradle
         target:
         insert: |

packages/website/docs/project-api.md

@@ -300,6 +300,15 @@ buildGradleFile.insertProperties(
   },
   [{ classpath: 'com.my.custom.gradle.plugin' }]
 );
+
+// To insert a variable assignment (thing = value) set the insertType to 'variable':
+buildGradleFile.insertProperties(
+  {
+    buildscript: {},
+  },
+  insertType: 'variable',
+  [{ firebaseMessagingVersion: '20.0.6' }]
+);
 ```
 
 To add raw Gradle strings: