DOCSP-9737: [Charts] updates to Embedding SDK (#322)

Author: steveren

source/embedding-charts-sdk.txt

@@ -137,19 +137,21 @@ page by including it as part of a header script tag.
        <button id="refresh">Refresh Chart</button>
        <div id="chart"></div>
        <script>
-         const sdk = new ChartsEmbedSDK;
+         const sdk = new ChartsEmbedSDK({
+           baseUrl: '<your-base-url>'
+         });
          // when using npm:
          // import ChartsEmbedSDK from '@mongodb-js/charts-embed-dom';
 
          const chart = sdk
            .createChart({
-             baseUrl: '<your-base-url>',
              chartId: '<your-chart-id>',
              width: 500,
              height: 500,
              refreshInterval: 300
-           })
-           .render(document.getElementById('chart'));
+           });
+    
+         chart.render(document.getElementById('chart'));
        </script>
      </body>
    </html>
@@ -158,7 +160,8 @@ Option Reference
 ----------------
 
 The following options are available to the JavaScript ``createChart``
-method:
+method. After the chart is created, you can control the configuration
+of the chart by calling methods on its handle.
 
 .. list-table::
    :header-rows: 1
@@ -181,13 +184,17 @@ method:
 
    * - ``height``
      - number
-     - Height of the chart, in pixels.
-     - yes
+     - Height of the chart. If no height is provided, it defaults to
+       the height of its container. If a value is provided without units,
+       it is assumed to be pixels (px).
+     - no
 
    * - ``width``
      - number
-     - Width of the chart, in pixels.
-     - yes
+     - Width of the chart. If no width is provided, it defaults to
+       the width of its container. If a value is provided without units,
+       it is assumed to be pixels (px).
+     - no
 
    * - ``filter``
      - object