more adaptor overview pages

adaptors/commcare.md

@@ -15,7 +15,7 @@ CommCare is an open source Digital Public Good built by
 [Dimagi](https://www.dimagi.com), which also offers paid options for use of its
 CommCare cloud-hosted platform SaaS.
 
-:::warning CommCare API Access
+:::info CommCare API Access
 
 If using CommCare SaaS, as of October '24, only 
 projects with the Pro Plan or above include API access
@@ -137,7 +137,7 @@ requiring you to set up a separate CommCare connection for each workflow.
 
 ## How to Extract or Modify CommCare Data
 
-**See the available [helper functions](adaptors/packages/commcare-docs)** for a
+**See the available [helper functions](/adaptors/packages/commcare-docs)** for a
 full list of functions supported by this adaptor for extracting and/or modifying
 CommCare data.
 

adaptors/common.md

@@ -0,0 +1,33 @@
+---
+title: Common Adaptor
+---
+
+## About OpenFn "Common" Language
+
+Use this adaptor to write JavaScript, or to leverage common expressions and
+[helper functions](/adaptors/packages/common-docs) for OpenFn.
+
+This adaptor is typically used for transforming data in OpenFn workflows that
+automate "ETL" (extract, transform, load) processes. See below examples.
+
+```js
+//use fn() to write your own functions
+fn(state => {
+  // write javascript...
+  // ...to do some things to state
+  console.log(state.data); //or to debug
+  return state;
+});
+```
+
+```js
+//use each() to create 1 account for each form
+each(
+  $.forms,
+  create('Account', {
+    Kobo_ID__c: $.data.id,
+    Name: $.data.customer_name,
+    Phone: $.data.customer_phone,
+  })
+);
+```