salesforce: docs deep dive

[josephjclark]

This issue is to do a deep docs review on Salesforce. I expect to contribute heavily to this myself. good examples

Requirements:

• state mutation JSdocs
• careful consistent language
• http helpers must explicitly clearly target salesforce
• update, create and upsert example supports multiple records
• bulk upsert example
• Example for each supported bulk operation
• Ensure examples are clear, concise, and demonstrate best practices.

[mtuchi]

I won't be able to work on this issue this week, We should probably promote to next week sprint