part 1 of api edits

@yudiatsfdc @nadeemg Here's a chunk of the updated API contents. Mostly small grammar/spelling stuff, but if anything incorrect in the content jumps out at you let me know and I'll push out another update.