Update Readme

Author: surajp

README.md

@@ -8,7 +8,7 @@ The button can be made available to users via a quick action powered by the `jsB
 
 ### The syntax
 
-This is the fun part. The syntax is quite permissive, with some restrictions, which I will cover below. I haven't, obviously, explored all possible scenarios and the information may still be incomplete. Please raise a PR if you come across something I haven't covered.
+This is the fun part. The syntax is quite permissive, with some restrictions, which I will cover below. I haven't, obviously, explored all possible scenarios and the information may still be incomplete. Please raise an issue if you come across something I haven't covered.
 
 * Simple examples (no soql/dml)
 
@@ -25,8 +25,8 @@ alert(Array(5).fill(0).map((e,i)=>'Hello, '+i));
 ```javascript 
 let accts=|| Select Name,(Select Id from Contacts) from Account order by createddate desc limit 100 ||;
 let contacts = accts.filter((a)=>!a.Contacts || a.Contacts.length===0).slice(0,10).map((a)=>({LastName: a.Name+'-Contact', AccountId: a.Id}));
-let contactIds = || insert Contact(contacts) ||; //Note how the SObjectType has been specified. This is required for insert and upsert
-$A.get('e.force:refreshView').fire(); // $A is supported!
+let contactIds = || insert Contact(contacts) ||; /*Note how the SObjectType has been specified. This is required for insert and upsert*/
+$A.get('e.force:refreshView').fire(); /* $A is supported!*/
 ```
 
 * Act in the context of the current record
@@ -40,7 +40,20 @@ alert(acct[0].NumberOfEmployees);
 $A.get('e.force:refreshView').fire();
 ```
 
+### About the syntax
 
+* Note how the syntax is linear for SOQL and DML. Coupled with JavaScript's support for manipulating arrays, this makes it easier to manipulate data, even compared to Apex in several instances.
+* SOQL and DML statements must be enclosed in `||`. Semi-colon can be inside or outside the `||`
+* Upsert and Update statements must be qualified with the SObjectType thus `|| insert Account(accts) ||;`
+* SOQL statements are parsed using template literals. Any arguments should follow the appropriate syntax `${argument}`
+* SOQL and DML statements may not be wrapped in a function.
+
+### Known Limitations
+
+* Single-line comments are not supported. 
+* Haven't tested DML with date, datetime, boolean, geolocation and other compound fields. I will update this section as I do so.
+* Explicit use of async/await, Promises and Generators is not supported, atm.
+* DML on Files, Attachments, Documents, etc. is not supported
 
 ### Developers: Extending to more than one button per SObject Type